Share via

AllocCountedString 函数

  • 项目

注意

从Windows 10开始，网络访问保护平台不可用

AllocCountedString 函数为以 null 结尾的字符串分配内存，并在 CountedString 结构中返回该内存。

语法

NAPAPI HRESULT WINAPI AllocCountedString(
  _Inout_       CountedString **countedString,
  _In_    const WCHAR         *string
);

参数

countedString [in， out]

指向新分配的 CountedString 结构的地址的指针。

string [in]

指向将在 countedString 中返回的以 null 结尾的字符串的指针。

返回值

返回代码 说明
S_OK
 操作已成功完成。
E_INVALIDARG
 传递的自变量无效。
E_OUTOFMEMORY
 系统已用完虚拟内存。 此操作失败。

备注

NAP 系统支持的所有 COM 接口都使用标准 COM 内存管理规则和 COM 内存分配器 (CoTaskMemAlloc 和 CoTaskMemFree) ：

  • 在 中 ，参数由调用方分配和释放。
  • Out 参数由被调用方分配，并由调用方使用 CoTaskMem 释放。
  • 输入/输出 参数由调用方分配，被调用方释放和重新分配，并最终由调用方使用 CoTaskMem 释放。

用于释放内存的所有 NAP 函数也会释放所有嵌入的指针。

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
NapUtil.h
DLL
Qutil.dll

另请参阅

FreeCountedString