Share via


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 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Netmon.h
程式庫
Nmapi.lib
DLL
Nmapi.dll