estrutura ENUM_SERVICE_STATUS_PROCESSA (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 o serviço. Ele é usado pela função EnumServicesStatusEx .

Sintaxe

typedef struct _ENUM_SERVICE_STATUS_PROCESSA {
  LPSTR                  lpServiceName;
  LPSTR                  lpDisplayName;
  SERVICE_STATUS_PROCESS ServiceStatusProcess;
} ENUM_SERVICE_STATUS_PROCESSA, *LPENUM_SERVICE_STATUS_PROCESSA;

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 em Painel de Controle, para identificar o serviço. Essa cadeia de caracteres tem um tamanho máximo de 256 caracteres. O caso é preservado no gerenciador de controle de serviço. As comparações de nome de exibição sempre diferenciam maiúsculas de minúsculas.

ServiceStatusProcess

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

Comentários

Observação

O cabeçalho winsvc.h define ENUM_SERVICE_STATUS_PROCESS 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 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 (inclua Windows.h)

Confira também

EnumServicesStatusEx

SERVICE_STATUS_PROCESS