struttura SERVICE_NOTIFY_2A (winsvc.h)
Rappresenta le informazioni di notifica dello stato del servizio. Viene usato dalla funzione NotifyServiceStatusChange .
Sintassi
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;
Members
dwVersion
Versione della struttura. Questo membro deve essere SERVICE_NOTIFY_STATUS_CHANGE (2).
pfnNotifyCallback
Puntatore alla funzione di callback. Per altre informazioni, vedere la sezione Osservazioni.
pContext
Tutti i dati definiti dall'utente da passare alla funzione di callback.
dwNotificationStatus
Valore che indica lo stato della notifica. Se questo membro è ERROR_SUCCESS, la notifica è riuscita e il membro ServiceStatus contiene informazioni valide. Se questo membro è ERROR_SERVICE_MARKED_FOR_DELETE, il servizio è stato contrassegnato per l'eliminazione e l'handle del servizio utilizzato da NotifyServiceStatusChange deve essere chiuso.
ServiceStatus
Struttura SERVICE_STATUS_PROCESS che contiene le informazioni sullo stato del servizio. Questo membro è valido solo se dwNotificationStatus è ERROR_SUCCESS.
dwNotificationTriggered
Se dwNotificationStatus è ERROR_SUCCESS, questo membro contiene una maschera di bit delle notifiche che hanno attivato questa chiamata alla funzione di callback.
pszServiceNames
Se dwNotificationStatus è ERROR_SUCCESS e la notifica viene SERVICE_NOTIFY_CREATED o SERVICE_NOTIFY_DELETED, questo membro è valido ed è una stringa MULTI_SZ che contiene uno o più nomi di servizio. I nomi dei servizi creati avranno un prefisso "/" in modo da poterli distinguere dai nomi dei servizi eliminati.
Se questo membro è valido, la funzione di callback di notifica deve liberare la stringa usando la funzione LocalFree .
Commenti
La funzione di callback viene dichiarata come segue:
typedef VOID( CALLBACK * PFN_SC_NOTIFY_CALLBACK ) (
IN PVOID pParameter
);
La funzione di callback riceve un puntatore alla struttura SERVICE_NOTIFY fornita dal chiamante.
Nota
L'intestazione winsvc.h definisce SERVICE_NOTIFY_2 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | winsvc.h (include Windows.h) |