Retrieve all entries in the specified groups. If that would take too long, return kDirDirectoryTooLargeToList. This may be used in the user interface to immediately display the contents of a small directory or group, so responsiveness is important.

A directory attribute collection is used to set output options of a directory connection.

The collection is represented in an ASCab as:

{ ("0", "nameOfAttribute1"), ("1", "nameOfAttribute2"), ... }

A directory information structure contains configuration settings used to establish a connection to a directory. Common top-level properties are defined below. Note that the prefix DirStdEntry_ is reserved for standard entries and should not be used for entries specific to a particular directory. Optionally, this could contain other configuration information specific to the directory.

A directory information list ASCab contains a vector of nested DirectoryInfo ASCab objects, one for every directory contained within the engine. Each directory ASCab contains a user interface name as an ASText and a unique ID as an ASAtom.

See Also

Group names are represented as text in an ASCab. For example:

{ ("0", "friends"), ("1", "family"), ... }

Search and enumeration results are represented as a two-dimensional ASCab where each "row" is itself an ASCab that contains attributes defined by SetOutputOptions calls.

Directory search criteria are represented as a set of key/value pairs where the keys are attribute names and the values are search strings applied to those attributes. A logical "AND" is implied when multiple search criteria are present. Unrecognized search criteria are ignored.

A directory connection object structure.

If a function returns -1 or less, you can call a GetLastError appropriate to the context and retrieve information about the last error. That call may return NULL which basically means "Unknown Error". Note that in the presence of threads, the error information may become inaccurate.

Closes the specified directory connection.

Pops up a custom user interface that allows the user to set search criteria and execute the search.

Retrieves information about the directory associated with the connection.

Retrieves the list of groups that this connection supports.

Retrieves information about the last error that occurred in the specified connection.

TBD

TBD

Special case: The ATTR_Certificates attribute is intended to encompass all certificate attributes a directory might have. If ATTR_Certificates is requested, it may have to be translated into several attributes depending on the directory.

TBD