ITRendezvous：：CreateDirectory 方法 (rend.h)

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

CreateDirectory 方法创建一个 ITDirectory 对象，该对象对应于给定类型和名称的目录。

语法

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

parameters

[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