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) |