ITRendezvous::CreateDirectory メソッド (rend.h)
[ランデブー IP テレフォニー会議のコントロールとインターフェイスは、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムでは使用できません。 RTC クライアント API も同様の機能を提供します。
CreateDirectory メソッドは、指定された型と名前のディレクトリに対応する ITDirectory オブジェクトを作成します。
構文
HRESULT CreateDirectory(
[in] DIRECTORY_TYPE DirectoryType,
[in] BSTR pName,
[out] ITDirectory **ppDir
);
パラメーター
[in] DirectoryType
ディレクトリの型。 「DIRECTORY_TYPE」を参照してください。
[in] pName
作成するディレクトリの名前を含む BSTR へのポインター。
[out] ppDir
上記で指定した型の ITDirectory オブジェクトを受け取るポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 説明 |
---|---|
|
メソッドが成功しました。 |
|
操作を実行するためのメモリが不足しています。 |
|
pName または ppDir パラメーターは無効なポインターです。 |
|
DirectoryType パラメーターが無効です。 |
解説
DT_NTDS型のディレクトリの場合、Rendezvous ではローカル ドメイン コントローラー (DC) のみを使用することがサポートされているため、 pName は無視されます。
アプリケーションでは 、SysAllocString を使用して pName パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。
TAPI は、ITRendezvous::CreateDirectory によって返される ITDirectory インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITDirectory インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。
この関数は、暗号化されていない形式でネットワーク経由でデータを送信する場合があります。そのため、ネットワーク上で傍受しているユーザーがデータを読み取ることができる可能性があります。 この方法を使用する前に、クリア テキストでデータを送信するセキュリティ リスクを考慮する必要があります。
必要条件
対象プラットフォーム | Windows |
ヘッダー | rend.h |
[DLL] | Rend.dll |