ITDirectory：：EnumerateDirectoryObjects 方法 (rend.h)

项目
08/25/2023

[会合 IP 电话会议控件和接口不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 RTC 客户端 API 提供类似的功能。]

EnumerateDirectoryObjects 方法创建给定类型和名称的目录对象的枚举。

语法

HRESULT EnumerateDirectoryObjects(
  [in]  DIRECTORY_OBJECT_TYPE DirectoryObjectType,
  [in]  BSTR                  pName,
  [out] IEnumDirectoryObject  **ppEnumObject
);

parameters

[in] DirectoryObjectType

所需对象的 DIRECTORY_OBJECT_TYPE 条件。

[in] pName

指向包含对象完整或部分名称的 BSTR 的指针。支持“*”通配符。

[out] ppEnumObject

用于接收匹配对象的枚举器的 IEnumDirectoryObject 接口指针的指针。

返回值

此方法可以返回其中一个值。

值	含义
S_OK	方法成功。
RND_NOT_CONNECTED	ITDirectory：：Connect 方法尚未调用或未成功。
E_NOTIMPL	未实现此方法。

注解

应用程序必须使用 SysAllocString 为 pName 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。

TAPI 在 ITDirectory：：EnumerateDirectoryObjects 返回的 IEnumDirectoryObject 接口上调用 AddRef 方法。应用程序必须在 IEnumDirectoryObject 接口上调用 Release，以释放与之关联的资源。