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