Función ExpertAllocMemory

La función ExpertAllocMemory asigna memoria para el experto.

Sintaxis

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

Parámetros

hExpertKey

Identificador de experto único. Network Monitor pasa hExpertKey al experto cuando llama a la función Run .

nBytes [in]

Memoria asignada, medida en bytes.

pError [out]

Indicador de error. Si se produce un error en la función, el parámetro nBytes contiene el código de error. Si el código de error es NMERR_EXPERT_TERMINATE, el experto debe limpiarlo y devolverlo inmediatamente.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a la memoria asignada.

Si la función no se realiza correctamente, el valor devuelto es NULL y pError proporciona un código de error que indica el motivo del error.

Observaciones

Es importante tener en cuenta que un experto debe usar las funciones de asignación de memoria de Network Monitor (incluido ExpertReallocMemory) para la administración de memoria. Si se produce un error en el experto durante el tiempo de ejecución, el uso de estas funciones permitirá a Network Monitor liberar la memoria asignada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h
Biblioteca	Nmapi.lib
Archivo DLL	Nmapi.dll