Função de retorno de chamada especialista em DllMain

O especialista implementa a função DllMain . O sistema operacional chama DllMain para obter um identificador para uma instância do especialista.

Sintaxe

BOOL WINAPI DllMain(
  _Out_ HINSTANCE hInstance,
  _In_  ULONG     ulReason,
        LPVOID    Reserved
);

Parâmetros

hInstance [out]

Manipule para uma instância do especialista.

Se o especialista usar a interface do usuário do Monitor de Rede, o valor hInstance deverá ser armazenado em uma variável global. Essa abordagem é necessária somente quando o valor do parâmetro ulReason é definido como DLL_PROCESS_ATTACH.

ulReason [in]

Indicador de por que a função foi chamada. Um valor de DLL_PROCESS_ATTACH ( que se aplica quando a DLL é carregada pela primeira vez) indica que o especialista deve salvar o valor hInstance em uma variável global.

Com qualquer outro valor, todas as chamadas para a função DllMain podem ser ignoradas. Para obter uma lista de todos os sinalizadores possíveis definidos pelo sistema operacional, consulte DLLMain.

Reserved

O parâmetro não está em uso.

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função não for bem-sucedida, o valor retornado será FALSE.

Comentários

O sistema operacional chama a função de especialista DllMain quando um processo carrega ou descarrega a DLL especializada. A função de especialista em DllMain deve ser exportada somente se o especialista tiver uma interface do usuário para exibir a configuração ou os resultados e, em seguida, retornar apenas o valor de hInstance adequado.

A função de especialista DllMain baseia-se na função DllMain da biblioteca de vínculo dinâmico.

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	Process.h