estrutura SERVICE_DESCRIPTIONA (winsvc.h)

  • Artigo

Contém uma descrição do serviço.

Sintaxe

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

Membros

lpDescription

A descrição do serviço. Se esse membro for NULL, a descrição permanecerá inalterada. Se esse valor for uma cadeia de caracteres vazia (""), a descrição atual será excluída.

A descrição do serviço não deve exceder o tamanho de um valor de registro do tipo REG_SZ.

Esse membro pode especificar uma cadeia de caracteres localizada usando o seguinte formato:

@[path]dllname,-strID

A cadeia de caracteres com o strID do identificador é carregada de dllname; o caminho é opcional. Para obter mais informações, consulte RegLoadMUIString.

Windows Server 2003 e Windows XP: Não há suporte para cadeias de caracteres localizadas até o Windows Vista.

Comentários

Uma descrição de NULL indica que nenhuma descrição de serviço existe. A descrição do serviço é NULL quando o serviço é criado.

A descrição é simplesmente um comentário que explica a finalidade do serviço. Por exemplo, para o serviço DHCP, você pode usar a descrição "Fornece endereços de Internet para o computador em sua rede".

Você pode definir a descrição usando a função ChangeServiceConfig2 . Você pode recuperar a descrição usando a função QueryServiceConfig2 . A descrição também é exibida pelo snap-in Serviços.

Exemplos

Para obter um exemplo, consulte Alterando a configuração de um serviço ou consultando a configuração de um serviço.

Observação

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

Confira também

ChangeServiceConfig2

QueryServiceConfig2