SERVICE_NOTIFY_2W-Struktur (winsvc.h)

Stellt Dienst status Benachrichtigungsinformationen dar. Sie wird von der Funktion NotifyServiceStatusChange verwendet.

Syntax

typedef struct _SERVICE_NOTIFY_2W {
  DWORD                  dwVersion;
  PFN_SC_NOTIFY_CALLBACK pfnNotifyCallback;
  PVOID                  pContext;
  DWORD                  dwNotificationStatus;
  SERVICE_STATUS_PROCESS ServiceStatus;
  DWORD                  dwNotificationTriggered;
  LPWSTR                 pszServiceNames;
} SERVICE_NOTIFY_2W, *PSERVICE_NOTIFY_2W;

Member

dwVersion

Die Strukturversion. Dieses Element 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 die status Benachrichtigung angibt. Wenn dieser Member ERROR_SUCCESS ist, wurde die Benachrichtigung erfolgreich ausgeführt, und das ServiceStatus-Mitglied enthält gültige Informationen. Wenn dieser Member ERROR_SERVICE_MARKED_FOR_DELETE ist, wurde der Dienst zum Löschen markiert, und das von NotifyServiceStatusChange verwendete Diensthandle muss geschlossen werden.

ServiceStatus

Eine SERVICE_STATUS_PROCESS-Struktur, die den Dienst status Informationen enthält. Dieser Member ist nur gültig, wenn dwNotificationStatusERROR_SUCCESS ist.

dwNotificationTriggered

Wenn dwNotificationStatusERROR_SUCCESS ist, enthält dieses Element eine Bitmaske der Benachrichtigungen, die diesen Aufruf der Rückruffunktion ausgelöst haben.

pszServiceNames

Wenn dwNotificationStatusERROR_SUCCESS ist und die Benachrichtigung SERVICE_NOTIFY_CREATED oder SERVICE_NOTIFY_DELETED ist, ist dieser Member gültig und eine MULTI_SZ Zeichenfolge, die mindestens einen Dienstnamen enthält. Die Namen der erstellten Dienste haben ein Präfix "/", sodass Sie sie von den Namen der gelöschten Dienste unterscheiden können.

Wenn dieser Member gültig ist, muss die Benachrichtigungsrückruffunktion die Zeichenfolge mithilfe der Funktion LocalFree freigeben.

Hinweise

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.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winsvc.h (einschließen von Windows.h)

Weitere Informationen

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS