Callback-functie LdrDllNotification

[Deze functie kan zonder verdere kennisgeving worden gewijzigd of verwijderd uit Windows.]

Een callback-functie voor meldingen die is opgegeven met de functie LdrRegisterDllNotification. De loader roept deze functie aan wanneer een DLL voor het eerst wordt geladen.

Syntaxis

VOID CALLBACK LdrDllNotification(
  _In_     ULONG                       NotificationReason,
  _In_     PCLDR_DLL_NOTIFICATION_DATA NotificationData,
  _In_opt_ PVOID                       Context
);

Parameters

NotificationReason [in]

De reden waarom de callback-functie voor meldingen is aangeroepen. Deze parameter kan een van de volgende waarden zijn.

Waarde	Betekenis
LDR_DLL_NOTIFICATION_REASON_LOADED 1	Het DLL-bestand is geladen. De parameter NotificationData verwijst naar een LDR_DLL_LOADED_NOTIFICATION_DATA-structuur.
LDR_DLL_NOTIFICATION_REASON_UNLOADED 2	Het DLL-bestand is uitgepakt. De parameter NotificationData verwijst naar een LDR_DLL_UNLOADED_NOTIFICATION_DATA structuur.

 

NotificationData [in]

Een aanwijzer naar een constante LDR_DLL_NOTIFICATION samenvoeging die meldingsgegevens bevat. Deze samenvoeging heeft de volgende definitie:

typedef union _LDR_DLL_NOTIFICATION_DATA {
    LDR_DLL_LOADED_NOTIFICATION_DATA Loaded;
    LDR_DLL_UNLOADED_NOTIFICATION_DATA Unloaded;
} LDR_DLL_NOTIFICATION_DATA, *PLDR_DLL_NOTIFICATION_DATA;

De LDR_DLL_LOADED_NOTIFICATION_DATA structuur heeft de volgende definitie:

typedef struct _LDR_DLL_LOADED_NOTIFICATION_DATA {
    ULONG Flags;                    //Reserved.
    PCUNICODE_STRING FullDllName;   //The full path name of the DLL module.
    PCUNICODE_STRING BaseDllName;   //The base file name of the DLL module.
    PVOID DllBase;                  //A pointer to the base address for the DLL in memory.
    ULONG SizeOfImage;              //The size of the DLL image, in bytes.
} LDR_DLL_LOADED_NOTIFICATION_DATA, *PLDR_DLL_LOADED_NOTIFICATION_DATA;

De LDR_DLL_UNLOADED_NOTIFICATION_DATA-structuur heeft de volgende definitie:

typedef struct _LDR_DLL_UNLOADED_NOTIFICATION_DATA {
    ULONG Flags;                    //Reserved.
    PCUNICODE_STRING FullDllName;   //The full path name of the DLL module.
    PCUNICODE_STRING BaseDllName;   //The base file name of the DLL module.
    PVOID DllBase;                  //A pointer to the base address for the DLL in memory.
    ULONG SizeOfImage;              //The size of the DLL image, in bytes.
} LDR_DLL_UNLOADED_NOTIFICATION_DATA, *PLDR_DLL_UNLOADED_NOTIFICATION_DATA;

Context [in, optioneel]

Een aanwijzer naar contextgegevens voor de callback-functie.

Retourwaarde

Deze callback-functie retourneert geen waarde.

Opmerkingen

De callback-functie voor meldingen wordt aangeroepen voordat dynamische koppelingen plaatsvinden.

Eisen

Zie ook

LdrRegisterDllNotification-

LdrUnregisterDllNotification-