ITDirectory::EnumerateDirectoryObjects-Methode (rend.h)
[Steuerelemente und Schnittstellen für Rendezvous-IP-Telefonkonferenzen sind in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems nicht verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]
Die EnumerateDirectoryObjects-Methode erstellt eine Enumeration von Verzeichnisobjekten eines bestimmten Typs und Namens.
Syntax
HRESULT EnumerateDirectoryObjects(
[in] DIRECTORY_OBJECT_TYPE DirectoryObjectType,
[in] BSTR pName,
[out] IEnumDirectoryObject **ppEnumObject
);
Parameter
[in] DirectoryObjectType
Die DIRECTORY_OBJECT_TYPE Kriterien für das gewünschte Objekt.
[in] pName
Zeiger auf einen BSTR, der den vollständigen oder teilweisen Namen des Objekts enthält. Das "*"-Wildcard wird unterstützt.
[out] ppEnumObject
Zeiger zum Empfangen des IEnumDirectoryObject-Schnittstellenzeigers für den Enumerator von übereinstimmenden Objekten.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Die ITDirectory::Connect-Methode wurde nicht aufgerufen oder war nicht erfolgreich. |
|
Diese Methode ist nicht implementiert. |
Hinweise
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pName-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.
TAPI ruft die AddRef-Methode für die IEnumDirectoryObject-Schnittstelle auf, die von ITDirectory::EnumerateDirectoryObjects zurückgegeben wird. Die Anwendung muss Release für die IEnumDirectoryObject-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Requirements (Anforderungen)
| Zielplattform | Windows |
| Kopfzeile | rend.h |
| DLL | Rend.dll |