estrutura SERVICE_NOTIFY_2A (winsvc.h)

Artigo
11/20/2024

Representa informações de notificação de status do 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 da notificação. Se esse membro for ERROR_SUCCESS, a notificação terá êxito e o membro ServiceStatus contém 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 do serviço. Esse membro só será válido se dwNotificationStatus estiver 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á uma cadeia de caracteres MULTI_SZ 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 .

Observações

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
cabeçalho	winsvc.h (incluir Windows.h)

Consulte também

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS

Compartilhar via