estrutura SERVICE_NOTIFY_2A (winsvc.h)

Representa informações de notificação de status de serviço. Ele é usado pela função NotifyServiceStatusChange .

Sintaxe

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;

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 distingui-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 de 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 (inclua Windows.h)

Confira também

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS