ITRendezvous::CreateDirectoryObject 方法 (rend.h)

[会合 IP 电话会议控件和接口不适用于 Windows Vista、Windows Server 2008 和操作系统的后续版本。 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
指针无效。

注解

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

TAPI 在 ITRendezvous::CreateDirectoryObject 返回的 ITDirectoryObject 接口上调用 AddRef 方法。 应用程序必须在 ITDirectoryObject 接口上调用 Release,以释放与其关联的资源。

此函数可能以未加密的形式通过网络发送数据;因此,在网络上窃听的人可能能够读取数据。 使用此方法之前,应考虑以明文形式发送数据的安全风险。

要求

要求
目标平台 Windows
标头 rend.h
DLL Rend.dll

另请参阅

DIRECTORY_OBJECT_TYPE

ITDirectoryObject

ITRendezvous