struttura SERVICE_NOTIFY_2A (winsvc.h)

  • Articolo

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)

Vedi anche

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS