estrutura SERVICE_NOTIFY_2W (winsvc.h)
Representa informações de notificação de status de serviço. Ele é usado pela função NotifyServiceStatusChange .
Sintaxe
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;
Membros
dwVersion
A versão da estrutura. Esse membro deve ser SERVICE_NOTIFY_STATUS_CHANGE (2).
pfnNotifyCallback
Um ponteiro para a função de retorno de chamada. Para obter mais informações, consulte Comentários.
pContext
Todos os dados definidos pelo usuário a serem passados para a função de retorno de chamada.
dwNotificationStatus
Um valor que indica o status de notificação. Se esse membro for ERROR_SUCCESS, a notificação terá êxito e o membro ServiceStatus conterá informações válidas. Se esse membro for ERROR_SERVICE_MARKED_FOR_DELETE, o serviço foi marcado para exclusão e o identificador de serviço usado por NotifyServiceStatusChange deverá ser fechado.
ServiceStatus
Uma estrutura SERVICE_STATUS_PROCESS que contém as informações de status de serviço. Esse membro só será válido se dwNotificationStatus for ERROR_SUCCESS.
dwNotificationTriggered
Se dwNotificationStatus for ERROR_SUCCESS, esse membro conterá uma máscara de bits das notificações que dispararam essa chamada para a função de retorno de chamada.
pszServiceNames
Se dwNotificationStatus for ERROR_SUCCESS e a notificação for SERVICE_NOTIFY_CREATED ou SERVICE_NOTIFY_DELETED, esse membro será válido e será um MULTI_SZ cadeia de caracteres que contém um ou mais nomes de serviço. Os nomes dos serviços criados terão um prefixo '/' para que você possa diferenciá-los dos nomes dos serviços excluídos.
Se esse membro for válido, a função de retorno de chamada de notificação deverá liberar a cadeia de caracteres usando a função LocalFree .
Comentários
A função de retorno de chamada é declarada da seguinte maneira:
typedef VOID( CALLBACK * PFN_SC_NOTIFY_CALLBACK ) (
IN PVOID pParameter
);
A função de retorno de chamada recebe um ponteiro para a estrutura SERVICE_NOTIFY fornecida pelo chamador.
Observação
O cabeçalho winsvc.h define SERVICE_NOTIFY_2 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
Cabeçalho | winsvc.h (incluir Windows.h) |