Função ExpertAllocMemory

A função ExpertAllocMemory aloca memória para o especialista.

Sintaxe

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

Parâmetros

hExpertKey

Identificador de especialista exclusivo. O Monitor de Rede passa hExpertKey para o especialista quando ele chama a função Executar .

nBytes [in]

Memória alocada, medida em bytes.

pError [out]

Indicador de erro. Se a função falhar, o parâmetro nBytes conterá o código de erro. Se o código de erro for NMERR_EXPERT_TERMINATE, o especialista deverá limpo e retornar imediatamente.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um ponteiro para a memória alocada.

Se a função não for bem-sucedida, o valor retornado será NULL e pError fornecerá um código de erro que indica o motivo da falha.

Comentários

É importante observar que um especialista deve usar as funções de alocação de memória do Monitor de Rede (incluindo ExpertReallocMemory) para gerenciamento de memória. Se o especialista falhar durante o tempo de execução, o uso dessas funções permitirá que o Monitor de Rede libere a memória alocada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Netmon.h
Biblioteca	Nmapi.lib
DLL	Nmapi.dll