AllocADsStr 函数 (adshlp.h)

AllocADsStr 函数为 分配内存,并复制指定的字符串。

语法

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

参数

[in] pStr

类型: LPWSTR

指向要复制的以 null 结尾的 Unicode 字符串的指针。

返回值

类型: LPWSTR

如果成功,该函数将返回指向已分配内存的非 NULL 指针。 pStr 中的字符串将复制到此缓冲区,并且以 null 结尾。 当不再需要此内存时,调用方必须释放此内存,方法是将返回的指针传递给 FreeADsStr

如果未成功,则返回 NULL 。 调用 ADsGetLastError 以获取扩展错误状态。 有关错误代码值的详细信息,请参阅 ADSI 错误代码

注解

有关详细信息和演示如何使用 AllocADsStr 函数的代码示例,请参阅 ReallocADsStr

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 adshlp.h
Library Activeds.lib
DLL Activeds.dll

另请参阅

ADSI 函数

ADsGetLastError

FreeADsStr

ReallocADsStr