ITDirectory::get_DirectoryObjects メソッド (rend.h)

[アーティクル]
03/01/2024

[ランデブー IP テレフォニー会議のコントロールとインターフェイスは、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティングシステムでは使用できません。 RTC クライアント API も同様の機能を提供します。

get_DirectoryObjects メソッドは、特定の条件に一致する特定のディレクトリ内のオブジェクトのコレクションを取得します。このメソッドは EnumerateDirectoryObjects と同じ関数を実行しますが、Visual Basic やその他のスクリプト言語で使用されます。

構文

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

パラメーター

[in] DirectoryObjectType

目的のオブジェクトの DIRECTORY_OBJECT_TYPE 条件。

[in] pName

オブジェクトの完全または部分的な名前を含む BSTR へのポインター。 "*" ワイルドカードがサポートされています。

[out] pVariant

説明に一致するサーバー内の ITDirectoryObject オブジェクトの ITCollection を受け取る VARIANT へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	意味
S_OK	メソッドが成功しました。
RND_NOT_CONNECTED	ITDirectory::Connect メソッドが呼び出されていないか、成功しませんでした。
E_NOTIMPL	このメソッドは実装されていません。

注釈

アプリケーションでは、SysAllocString を使用して pName パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。

TAPI は、ITDirectory::get_DirectoryObjects によって返される ITDirectoryObject インターフェイスで AddRef メソッドを呼び出します。アプリケーションは、ITDirectoryObject インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。