estrutura SERVICE_DESCRIPTIONA (winsvc.h)
Contém uma descrição de serviço.
Sintaxe
typedef struct _SERVICE_DESCRIPTIONA {
LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;
Membros
lpDescription
A descrição do serviço. Se esse membro estiver 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:
@[caminho]dllname,-strID
A cadeia de caracteres com 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.
Observações
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 o de configuração de um serviço ou consultando ode configuração de um serviço.
Nota
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 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