Platform SDK: TAPI

ITDirectory::EnumerateDirectoryObjects

Creates enumeration of directory objects of a given type and name.

HRESULT EnumerateDirectoryObjects(
  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  BSTR pName,
  IEnumDirectoryObject **ppEnumObject
);

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.
ppEnumObject
[out] Pointer to receive IEnumDirectoryObject interface pointer for the enumerator of matching objects.

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