Share via

ITRendezvous：：CreateDirectory 方法 (rend.h)

  • 發行項

[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 提供類似的功能。]

CreateDirectory方法會建立對應至指定類型和名稱目錄的 ITDirectory 物件。

語法

HRESULT CreateDirectory(
  [in]  DIRECTORY_TYPE DirectoryType,
  [in]  BSTR           pName,
  [out] ITDirectory    **ppDir
);

參數

[in] DirectoryType

目錄的類型。 請參閱 DIRECTORY_TYPE。

[in] pName

BSTR的指標，其中包含要建立之目錄的名稱。

[out] ppDir

接收上述類型之 ITDirectory 物件的指標。

傳回值

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

值 意義
S_OK
 方法成功。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。
E_POINTER
 pName或ppDir參數是不正確指標。
E_INVALIDARG
 DirectoryType參數無效。

備註

對於類型為 DT_NTDS 的目錄，會忽略 pName ，因為 Rendezvous 僅支援使用本機網域控制站 (DC) 。

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

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

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

需求

   
目標平台 Windows
標頭 rend.h
Dll Rend.dll

另請參閱

DIRECTORY_TYPE

ITDirectory

ITRendezvous