Compartilhar via


estrutura ENUM_SERVICE_STATUSA (winsvc.h)

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 o caso 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 no Painel de Controle, para identificar o serviço. Essa cadeia de caracteres tem um comprimento máximo de 256 caracteres. O nome é preservado por maiúsculas de 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 informações de status para o serviço lpServiceName .

Observações

Nota

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 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 XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho winsvc.h (incluir Windows.h)

Consulte também

EnumDependentServices

EnumServicesStatus

SERVICE_STATUS