estrutura ENUM_SERVICE_STATUS_PROCESSA (winsvc.h)

Artigo
11/20/2024

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 no Painel de Controle, para identificar o serviço. Essa cadeia de caracteres tem um comprimento 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.

Observações

Nota

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 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

EnumServicesStatusEx

SERVICE_STATUS_PROCESS

Compartilhar via