estrutura SERVICE_DESCRIPTIONW (winsvc.h)

  • Artigo

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

Sintaxe

typedef struct _SERVICE_DESCRIPTIONW {
  LPWSTR lpDescription;
} SERVICE_DESCRIPTIONW, *LPSERVICE_DESCRIPTIONW;

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 do 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 identificador strID é 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 não existe nenhuma descrição de serviço. 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

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 (incluir Windows.h)

Confira também

ChangeServiceConfig2

QueryServiceConfig2