Функция обратного вызова DllMain Expert
Эксперт реализует функцию DllMain . Операционная система вызывает DllMain , чтобы получить дескриптор экземпляра эксперта.
Синтаксис
BOOL WINAPI DllMain(
_Out_ HINSTANCE hInstance,
_In_ ULONG ulReason,
LPVOID Reserved
);
Параметры
-
hInstance [out]
-
Обработка экземпляра эксперта.
Если эксперт использует пользовательский интерфейс сетевого монитора, значение hInstance должно храниться в глобальной переменной. Этот подход необходим, только если для параметра ulReason задано значение DLL_PROCESS_ATTACH.
-
ulReason [in]
-
Индикатор того, почему была вызвана функция. Значение DLL_PROCESS_ATTACH (которое применяется при первой загрузке библиотеки DLL) указывает, что специалисту следует сохранить значение hInstance в глобальной переменной.
При использовании любого другого значения все вызовы функции DllMain можно игнорировать. Список всех возможных флагов, установленных операционной системой, см. в разделе DLLMain.
-
Reserved
-
Параметр не используется.
Возвращаемое значение
Если функция выполнена успешно, возвращается значение TRUE.
Если функция завершается неудачно, возвращается значение FALSE.
Комментарии
Операционная система вызывает функцию эксперта DllMain , когда процесс загружает или выгружает библиотеку DLL эксперта. Функция эксперта DllMain должна экспортироваться только в том случае, если у эксперта есть пользовательский интерфейс для просмотра конфигурации или результатов, а затем только для возврата правильного значения hInstance .
Экспертная функция DllMain основана на функции DllMain библиотеки динамической компоновки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|