FACSys® Fax Messaging Gateway
Software Development Kit (SDK)
AFM & Web Services

Download
SDK


Contact

Introduction Object Model Tasks Samples & Programming Languages Packaging Troubleshooting FAQ Appendices

FaxPhonebooks Collection Object

The FaxPhonebooks collection object contains one or more FaxPhonebook objects available to the current session. The collection may include FaxPhonebook objects representing each "shared" phonebook, a personal phonebook (if any), and any external ODBC connections.

Properties

Name

Data Type

Access

Class

Long

Read-only

Parent

FaxSession object

Read-only

Session

FaxSession object

Read-only

     

Count

Long

Read-only

Item

FaxPhonebook object

Read-only

 

 

Methods

Name

Input Parameters

Return Values

Add

Name as String,
Type as Long,
(Optional) Source as String

FaxPhonebook object

Remove

Index as Long

 
 

 

Remarks

Use the Item property to reference a particular FaxPhonebook object.

Back to Top

 

Add Method

The Add method creates and returns a new FaxPhonebook object in the FaxPhonebooks collection. The Add method also creates server based resources associated with the new FaxPhonebook.

Syntax

ObjPhonebooks.Add (Name, Type)

Remarks

The Name parameter (string) is the name to be assigned to the new phonebook.

The Type parameter (long) defines the phonebook type. Valid values for this property are defined by the FaxMsg_PhonebookType enumeration.

The optional Source parameter (string) definition depends on the phonebook type. For system phonebooks, this parameter is ignored. For personal phonebooks, the source string is the actual file name (.ndb). For ODBC links, this parameter is the name of the ODBC map file specifying the data source and field mappings for the connection.

Back to Top

 

Count Property

The Count property returns the number of FaxPhonebook objects contained in the collection. Read-only.

Syntax

ObjPhonebooks.Count

Data Type

Long

Back to Top

 

Item Property

The Item property returns a single FaxPhonebook object from the collection. Read-only.

Syntax

ObjPhonebooks.Item(Index)

where Index is a long integer ranging from 1 to the size of the collection (i.e., value of the Count property).

Data Type

FaxPhonebook object

Remarks

The Item property is the default property of the FaxPhonebooks object.

Back to Top

 

Remove Method

The Remove method deletes the FaxPhonebook object with the specified index from the collection. Server based resources associated with the phonebook are also deleted.

Syntax

ObjPhonebooks.Remove(Index)

where Index is a long integer ranging from 1 to the size of the collection (i.e., value of the Count property).

Remarks

The Remove method is irreversible. The phonebook will be deleted permanently from the FaxPhonebooks collection.

Back to Top

Session

Image

Constant Definitions

Error Codes


Common Properties

Folders

Folder

Messages

Message

Recipients

Recipient

Attachments

Attachment

Phonebooks

Phonebook

Containers

Container

Entries

Entry

Fields

Field

Coverpages

Coverpage

Users

User

Home  |  emFAST  |  FACSys  |  FACSys Support  |  Download Request  |  Contact