Compartilhar via


Função LdrRegisterDllNotification

[Essa função pode ser alterada ou removida do Windows sem aviso prévio.]

Registra-se para notificação quando uma DLL é carregada pela primeira vez. Essa notificação ocorre antes da vinculação dinâmica ocorrer.

Sintaxe

NTSTATUS NTAPI LdrRegisterDllNotification(
  _In_     ULONG                          Flags,
  _In_     PLDR_DLL_NOTIFICATION_FUNCTION NotificationFunction,
  _In_opt_ PVOID                          Context,
  _Out_    PVOID                          *Cookie
);

Parâmetros

Sinalizadores [in]

Esse parâmetro deve ser zero.

NotificationFunction [in]

Um ponteiro para uma função de retorno de chamada de notificação LdrDllNotification a ser chamada quando a DLL é carregada.

Contexto [in, opcional]

Um ponteiro para dados de contexto para a função de retorno de chamada.

Cookie [out]

Um ponteiro para uma variável para receber um identificador para a função de retorno de chamada. Esse identificador é usado para cancelar o registro da função de retorno de chamada de notificação.

Valor retornado

Se a função for bem-sucedida, ela retornará STATUS_SUCCESS.

Os formulários e a significância dos códigos de erro NTSTATUS são listados no arquivo de cabeçalho Ntstatus.h disponível no WDK e são descritos na documentação do WDK.

Comentários

Essa função não tem nenhum arquivo de cabeçalho associado. A biblioteca de importação associada, Ntdll.lib, está disponível no WDK. Você também pode usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Ntdll.dll.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
DLL
Ntdll.dll

Confira também

LdrDllNotification

LdrUnregisterDllNotification