Platform SDK: TAPI

ITDirectory::get_DirectoryObjects

Gets collection of objects in a given directory that match certain criteria. This method performs the same function as EnumerateDirectoryObjects but is used by Visual Basic and other scripting languages.

HRESULT get_DirectoryObjects(
  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  BSTR pName,
  VARIANT *pVariant
);

Parameters

DirectoryObjectType
[in] The DIRECTORY_OBJECT_TYPE criteria for object desired.
pName
[in] Pointer to a BSTR containing the full or partial name of the object. The "*" wildcard is supported.
pVariant
[out, retval] Pointer to a VARIANT that receives an ITCollection of ITDirectoryObject objects in the server that match the description.

Return Values

Value Meaning
S_OK Method succeeded.
RND_NOT_CONNECTED The ITDirectory::Connect method has not been invoked or did not succeed.
E_NOTIMPL This method is not implemented.

Remarks

The application must use SysAllocString to allocate memory for the pName parameter and use SysFreeString to free the memory when the variable is no longer needed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Rend.h.
  Library: Use Rendid.lib.

See Also

ITDirectory, DIRECTORY_OBJECT_TYPE, ITCollection, ITDirectoryObject