ITRendezvous：：CreateDirectoryObject 方法 (rend.h)

發行項
03/05/2024

[Rendezvous IP Telephony Conferencing controls and interface not available for use in Windows Vista， Windows Server 2008， and subsequent versions of the operating system. RTC 用戶端 API 提供類似的功能。]

CreateDirectoryObject 方法會建立新的 ITDirectoryObject 物件。

語法

HRESULT CreateDirectoryObject(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] ITDirectoryObject     **ppDirectoryObject
);

參數

[in] DirectoryObjectType

物件的類型。請參閱 DIRECTORY_OBJECT_TYPE。

[in] pName

包含物件名稱的 BSTR 指標。

[out] ppDirectoryObject

接收新建立之 ITDirectoryObject 對象的介面指標的指標。

傳回值

這個方法可以傳回下列其中一個值。

值	意義
S_OK	方法成功。
E_INVALIDARG	DirectoryObjectType 參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行作業。
E_POINTER	指標無效。

備註

應用程式必須使用 SysAllocString 為 pName 參數配置記憶體，並在不再需要變數時使用 SysFreeString 釋放記憶體。

TAPI 會在 ITRendezvous：：CreateDirectoryObject 所傳回的 ITDirectoryObject 介面上呼叫 AddRef 方法。應用程式必須在 ITDirectoryObject 介面上呼叫 Release，以釋放與其相關聯的資源。

此函式可能會以未加密的形式透過網路傳送數據;因此，網路上有人竊聽可能會讀取數據。使用此方法之前，應該先考慮以純文本傳送數據的安全性風險。