estrutura ENUM_SERVICE_STATUSA (winsvc.h)

  • Artigo

Contém o nome de um serviço em um banco de dados do gerenciador de controle de serviço e informações sobre esse serviço. Ele é usado pelas funções EnumDependentServices e EnumServicesStatus .

Sintaxe

typedef struct _ENUM_SERVICE_STATUSA {
  LPSTR          lpServiceName;
  LPSTR          lpDisplayName;
  SERVICE_STATUS ServiceStatus;
} ENUM_SERVICE_STATUSA, *LPENUM_SERVICE_STATUSA;

Membros

lpServiceName

O nome de um serviço no banco de dados do gerenciador de controle de serviço. O comprimento máximo da cadeia de caracteres é de 256 caracteres. O banco de dados do gerenciador de controle de serviço preserva as maiúsculas e minúsculas dos caracteres, mas as comparações de nome de serviço sempre diferenciam maiúsculas de minúsculas. Uma barra (/), barra invertida (\), vírgula e espaço são caracteres de nome de serviço inválidos.

lpDisplayName

Um nome de exibição que pode ser usado por programas de controle de serviço, como Serviços em Painel de Controle, para identificar o serviço. Essa cadeia de caracteres tem um tamanho máximo de 256 caracteres. O nome é preservado por maiúsculas e minúsculas no gerenciador de controle de serviço. As comparações de nome de exibição sempre diferenciam maiúsculas de minúsculas.

ServiceStatus

Uma estrutura SERVICE_STATUS que contém status informações para o serviço lpServiceName.

Comentários

Observação

O cabeçalho winsvc.h define ENUM_SERVICE_STATUS 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

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho winsvc.h (incluir Windows.h)

Confira também

EnumDependentServices

EnumServicesStatus

SERVICE_STATUS