Поделиться через


Функция ExpertAllocMemory

Функция ExpertAllocMemory выделяет память для эксперта.

Синтаксис

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

Параметры

hExpertKey

Уникальный идентификатор эксперта. Монитор сети передает hExpertKey эксперту при вызове функции Run .

nBytes [in]

Выделенная память, измеряемая в байтах.

pError [out]

Индикатор ошибки. Если функция завершается сбоем, параметр nBytes содержит код ошибки. Если код ошибки NMERR_EXPERT_TERMINATE, эксперт должен выполнить очистку и немедленно вернуться.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение представляет собой указатель на выделенную память.

Если функция не выполнена, возвращаемое значение равно NULL, а pError предоставляет код ошибки, указывающий причину сбоя.

Комментарии

Важно отметить, что эксперт должен использовать функции выделения памяти сетевого монитора (включая ExpertReallocMemory) для управления памятью. Если ваш эксперт завершается сбоем во время выполнения, использование этих функций позволит сетевому монитору освободить выделенную память.

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Netmon.h
Библиотека
Nmapi.lib
DLL
Nmapi.dll