PFNSTATUSMESSAGECALLBACK-Rückruffunktion (userenv.h)

Die StatusMessageCallback-Funktion ist eine anwendungsdefinierte Rückruffunktion, die zum Anzeigen status Nachrichten beim Anwenden einer Richtlinie verwendet wird. Der PFNSTATUSMESSAGECALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. StatusMessageCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFNSTATUSMESSAGECALLBACK Pfnstatusmessagecallback;

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

Parameter

[in] bVerbose

Gibt an, ob die Nachricht ausführlich ist. Wenn dieser Parameter TRUE ist, ist die Meldung ausführlich. Wenn dieser Parameter FALSE ist, ist die Meldung nicht ausführlich.

[in] lpMessage

Zeiger auf einen Puffer, der die Nachrichtenzeichenfolge enthält.

Rückgabewert

Wenn die Meldung erfolgreich angezeigt wurde, geben Sie ERROR_SUCCESS zurück. Andernfalls wird ein Systemfehlercode zurückgegeben.

Hinweise

Übergeben Sie einen Zeiger auf die StatusMessageCallback-Funktion , wenn das System die Rückruffunktion ProcessGroupPolicy oder ProcessGroupPolicyEx aufruft.

Die status Benutzeroberfläche verfügt über zwei Modi: Standard und ausführlich. Ausführliche Meldungen werden nur angezeigt, wenn sich der Computer im ausführlichen Modus befindet. Um den ausführlichen Modus zu aktivieren, legen Sie den folgenden Registrierungswert auf 1 fest, melden Sie sich ab, und melden Sie sich an. Es ist nicht erforderlich, den Computer neu zu starten.

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

Warnung Rufen Sie die StatusMessageCallback-Funktion nicht aus einem Hintergrundthread auf, da Sie die status Nachricht eines anderen Threads überschreiben können.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	userenv.h

Weitere Informationen

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien

ProcessGroupPolicy

ProcessGroupPolicyEx