ITDirectory::get_DirectoryObjects-Methode (rend.h)

Artikel
08/25/2023

[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 get_DirectoryObjects-Methode ruft die Auflistung von -Objekten in einem bestimmten Verzeichnis ab, die bestimmten Kriterien entspricht. Diese Methode führt dieselbe Funktion wie EnumerateDirectoryObjects aus, wird jedoch von Visual Basic und anderen Skriptsprachen verwendet.

Syntax

HRESULT get_DirectoryObjects(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] VARIANT               *pVariant
);

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] pVariant

Zeiger auf einen VARIANT-Wert , der eine ITCollection von ITDirectoryObject-Objekten auf dem Server empfängt, die der Beschreibung entsprechen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
RND_NOT_CONNECTED	Die ITDirectory::Connect-Methode wurde nicht aufgerufen oder war nicht erfolgreich.
E_NOTIMPL	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 auf der ITDirectoryObject-Schnittstelle auf, die von ITDirectory::get_DirectoryObjects zurückgegeben wird. Die Anwendung muss Release auf der ITDirectoryObject-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.