Funzione ExpertAllocMemory

La funzione ExpertAllocMemory alloca la memoria per l'esperto.

Sintassi

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

Parametri

hExpertKey

Identificatore esperto univoco. Monitoraggio di rete passa hExpertKey all'esperto quando chiama la funzione Run .

nBytes [in]

Memoria allocata, misurata in byte.

pError [out]

Indicatore di errore. Se la funzione ha esito negativo, il parametro nBytes contiene il codice di errore. Se il codice di errore è NMERR_EXPERT_TERMINATE, l'esperto deve pulire e restituire immediatamente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore alla memoria allocata.

Se la funzione ha esito negativo, il valore restituito è NULL e pError fornisce un codice di errore che indica il motivo dell'errore.

Commenti

È importante notare che un esperto deve usare le funzioni di allocazione della memoria di Monitoraggio di rete (incluso ExpertReallocMemory) per la gestione della memoria. Se l'esperto ha esito negativo durante l'esecuzione, l'uso di queste funzioni consentirà a Monitoraggio di rete di liberare la memoria allocata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h
Libreria	Nmapi.lib
DLL	Nmapi.dll