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 对象的指针。
返回值
此方法可以返回其中一个值。
值 | 含义 |
---|---|
|
方法成功。 |
|
内存不足,无法执行操作。 |
|
pName 或 ppDir 参数是无效的指针。 |
|
DirectoryType 参数无效。 |
注解
对于 DT_NTDS 类型的目录,将忽略 pName ,因为 Rendezvous 仅支持使用本地域控制器 (DC) 。
应用程序必须使用 SysAllocString 为 pName 参数分配内存,并在不再需要变量时使用 SysFreeString 释放内存。
TAPI 在 ITRendezvous::CreateDirectory 返回的 ITDirectory 接口上调用 AddRef 方法。 应用程序必须在 ITDirectory 接口上调用 Release,以释放与之关联的资源。
此函数可能以未加密的形式通过网络发送数据;因此,在网络上窃听的人可能能够读取数据。 在使用此方法之前,应考虑以明文形式发送数据的安全风险。
要求
目标平台 | Windows |
标头 | rend.h |
DLL | Rend.dll |