Настройка функции обратного вызова

Функция Configure настраивает эксперта в библиотеке DLL эксперта.

Эксперт должен реализовать функцию Configure . При получении вызова функции эксперт отображает диалоговое окно, позволяющее пользователю изменить любой настраиваемый элемент.

Синтаксис

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

Параметры

hExpertKey [in]

Уникальный идентификатор эксперта.

Уникальный идентификатор передается для всех функций монитора сети, относящихся к экспертам. Имейте в виду, что идентификатор может не совпадать с ключом эксперта, переданным в функцию Run . Не храните ключ эксперта из вызова Configure .

ppConfig [вход, выход]

Указатель на указатель на структуру EXPERTCONFIG при входе.

После успешного завершения работы упоминаемая структура EXPERTCONFIG содержит новые данные конфигурации.

pExpertStartupInfo [in]

Указатель на элемент захвата с фокусом при запуске эксперта.

StartupFlags [in]

Флаги, указывающие, как эксперт должен использовать параметр pExpertStartupInfo . Единственный определенный флаг — EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. Флаг указывает, что эксперт будет использовать параметр pExpertStartupInfo , а не переданный параметр ppConfig . Как правило, флаг устанавливается при запуске эксперта из контекстного меню.

hWnd [in]

Дескриптор родительского окна. Используйте дескриптор, чтобы открыть диалоговое окно.

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

При успешном выполнении функции (то есть при наличии текущей конфигурации) возвращается значение TRUE.

Если функция не работает, возвращается значение FALSE.

Комментарии

Монитор сети вызывает функцию Configure с текущей конфигурацией эксперта, если она существует. Эксперт отображает диалоговое окно, с помощью которого можно изменить любой настраиваемый элемент.

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

Данные конфигурации также могут иметь значение NULL при возврате функции Configure и передаче значения NULL . Эта ситуация возникает, когда монитор сети не имеет хранимого значения по умолчанию и пользователь нажимает кнопку Отмена.

В начале структуры данных EXPERTCONFIG содержится раздел Private, в котором хранятся сведения о размере структуры. Размер структуры EXPERTCONFIG должен включать зарезервированную длину DWORD , которая отображается в начале структуры. Например, если для данных конфигурации требуется 20 байт дискового пространства, выделите 24 байта для хранения данных. Если ppConfig имеет значение NULL, функция Configure вызывает функцию ExpertAllocMemory , чтобы выделить новую конфигурацию правильного размера. Если буфера недостаточно для хранения данных эксперта, эксперт должен вызвать функцию ExpertReallocMemory .

Требования

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