Fonction de rappel PFNSTATUSMESSAGECALLBACK (userenv.h)

Article
08/26/2023

La fonction StatusMessageCallback est une fonction de rappel définie par l’application utilisée pour afficher status messages lors de l’application de la stratégie. Le type PFNSTATUSMESSAGECALLBACK définit un pointeur vers cette fonction de rappel. StatusMessageCallback est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PFNSTATUSMESSAGECALLBACK Pfnstatusmessagecallback;

DWORD Pfnstatusmessagecallback(
  [in] BOOL bVerbose,
  [in] LPWSTR lpMessage
)
{...}

Paramètres

[in] bVerbose

Spécifie si le message est détaillé. Si ce paramètre a la valeur TRUE, le message est détaillé. Si ce paramètre a la valeur FALSE, le message n’est pas détaillé.

[in] lpMessage

Pointeur vers une mémoire tampon qui contient la chaîne de message.

Valeur retournée

Si le message s’est affiché correctement, retournez ERROR_SUCCESS. Sinon, retournez un code d’erreur système.

Remarques

Passez un pointeur vers la fonction StatusMessageCallback lorsque le système appelle la fonction de rappel ProcessGroupPolicy ou ProcessGroupPolicyEx .

L’interface utilisateur status a deux modes : standard et détaillé. Les messages détaillés ne s’affichent que lorsque l’ordinateur est en mode détaillé. Pour activer le mode détaillé, définissez la valeur de Registre suivante sur 1, déconnectez-vous et ouvrez une session. Il n’est pas nécessaire de redémarrer l’ordinateur.

HKEY_LOCAL_MACHINE\Logiciel\Microsoft\Windows NT\Currentversion\Winlogon\VerboseStatus

Avertissement N’appelez pas la fonction StatusMessageCallback à partir d’un thread d’arrière-plan, car vous pouvez remplacer le message status d’un autre thread.