SERVICE_NOTIFY_2A Struktur (winsvc.h)

Artikel
11/20/2024

Stellt Dienststatusbenachrichtigungsinformationen dar. Sie wird von der funktion NotifyServiceStatusChange verwendet.

Syntax

typedef struct _SERVICE_NOTIFY_2A {
  DWORD                  dwVersion;
  PFN_SC_NOTIFY_CALLBACK pfnNotifyCallback;
  PVOID                  pContext;
  DWORD                  dwNotificationStatus;
  SERVICE_STATUS_PROCESS ServiceStatus;
  DWORD                  dwNotificationTriggered;
  LPSTR                  pszServiceNames;
} SERVICE_NOTIFY_2A, *PSERVICE_NOTIFY_2A;

Angehörige

dwVersion

Die Strukturversion. Dieses Mitglied muss SERVICE_NOTIFY_STATUS_CHANGE (2) sein.

pfnNotifyCallback

Ein Zeiger auf die Rückruffunktion. Weitere Informationen finden Sie in den Hinweisen.

pContext

Alle benutzerdefinierten Daten, die an die Rückruffunktion übergeben werden sollen.

dwNotificationStatus

Ein Wert, der den Benachrichtigungsstatus angibt. Wenn dieses Mitglied ERROR_SUCCESSist, ist die Benachrichtigung erfolgreich, und das ServiceStatus- Mitglied enthält gültige Informationen. Wenn dieses Mitglied ERROR_SERVICE_MARKED_FOR_DELETEist, wurde der Dienst zum Löschen markiert, und der von NotifyServiceStatusChange verwendete Diensthandle muss geschlossen werden.

ServiceStatus

Eine SERVICE_STATUS_PROCESS Struktur, die die Dienststatusinformationen enthält. Dieses Element ist nur gültig, wenn dwNotificationStatus-ERROR_SUCCESSist.

dwNotificationTriggered

Wenn dwNotificationStatus-ERROR_SUCCESSist, enthält dieses Element eine Bitmaske der Benachrichtigungen, die diesen Aufruf an die Rückruffunktion ausgelöst haben.

pszServiceNames

Wenn dwNotificationStatus-ERROR_SUCCESS ist und die Benachrichtigung SERVICE_NOTIFY_CREATED oder SERVICE_NOTIFY_DELETEDist, ist dieses Element gültig und eine MULTI_SZ Zeichenfolge, die mindestens einen Dienstnamen enthält. Die Namen der erstellten Dienste weisen ein Präfix "/" auf, sodass Sie sie von den Namen der gelöschten Dienste unterscheiden können.

Wenn dieses Element gültig ist, muss die Benachrichtigungsrückruffunktion die Zeichenfolge mithilfe der funktion LocalFree freigeben.

Bemerkungen

Die Rückruffunktion wird wie folgt deklariert:

typedef VOID( CALLBACK * PFN_SC_NOTIFY_CALLBACK ) (
    IN PVOID pParameter 
);

Die Rückruffunktion empfängt einen Zeiger auf die vom Aufrufer bereitgestellte SERVICE_NOTIFY Struktur.

Anmerkung

Der winsvc.h-Header definiert SERVICE_NOTIFY_2 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Header-	winsvc.h (enthalten Windows.h)

Siehe auch

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS

Freigeben über