ITDirectory：：get_DirectoryObjects 方法 (rend.h)

  • 發行項

[Rendezvous IP Telephony 會議控件和介面不適用於 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

VARIANT 的指標，該 VARIANT 會接收符合描述之伺服器中 ITDirectoryObject 物件的 ITCollection。

傳回值

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

值 意義
S_OK
 方法成功。
RND_NOT_CONNECTED
 ITDirectory：：Connect 方法尚未叫用或未成功。
E_NOTIMPL
 這個方法尚未實作。

備註

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

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

規格需求

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

另請參閱

DIRECTORY_OBJECT_TYPE

ITCollection

ITDirectory

ITDirectoryObject