ExpertAllocMemory 函数

ExpertAllocMemory 函数为专家分配内存。

语法

LPVOID WINAPI ExpertAllocMemory(
        HEXPERTKEY hExpertKey,
  _In_  SIZE_T     nBytes,
  _Out_ LPDWORD    pError
);

参数

hExpertKey

唯一专家标识符。 网络监视器在调用 Run 函数时将 hExpertKey 传递给专家。

nBytes [in]

分配的内存，以字节为单位。

pError [out]

错误指示器。 如果函数失败， nBytes 参数将包含错误代码。 如果错误代码NMERR_EXPERT_TERMINATE，专家必须清理并立即返回。

返回值

如果函数成功，则返回值是指向已分配内存的指针。

如果函数不成功，则返回值为 NULL， pError 会提供指示失败原因的错误代码。

备注

请务必注意，专家应使用网络监视器内存分配函数 (包括用于内存管理的 ExpertReallocMemory) 。 如果专家在运行时失败，使用这些函数将允许网络监视器释放已分配的内存。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Netmon.h
库	Nmapi.lib
DLL	Nmapi.dll