estrutura SERVICE_DESCRIPTIONW (winsvc.h)
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) |