This example prompts for the name of a hotlist, then returns the number of items in that hotlist:
Sub GetNumItemsDemo ()
Dim items As Integer, yourChoice As String
yourChoice = InputBox$("Which hotlist would you like to check?")
items = Session.GetNumItems (yourChoice)
MsgBox "Number of items in that hotlist is " & items & "."
End Sub