estrutura SERVICE_REQUIRED_PRIVILEGES_INFOA (winsvc.h)

  • Artigo

Representa os privilégios necessários para um serviço.

Sintaxe

typedef struct _SERVICE_REQUIRED_PRIVILEGES_INFOA {
  LPSTR pmszRequiredPrivileges;
} SERVICE_REQUIRED_PRIVILEGES_INFOA, *LPSERVICE_REQUIRED_PRIVILEGES_INFOA;

Membros

pmszRequiredPrivileges

Uma cadeia de caracteres múltipla que especifica os privilégios. Para obter uma lista de valores possíveis, consulte Constantes de privilégio.

Uma cadeia de caracteres múltipla é uma sequência de cadeias de caracteres terminadas em nulo, terminadas por uma cadeia de caracteres vazia (\0). Veja este exemplo: String1\0String2\0String3\0LastString\0\0.

Comentários

A alteração nos privilégios necessários entrará em vigor na próxima vez que o serviço for iniciado. O SCM determina se o serviço pode dar suporte aos privilégios especificados quando tenta iniciar o serviço.

É melhor analisar seu serviço e usar o conjunto mínimo de privilégios necessários.

Se você não definir os privilégios necessários, o SCM usará todos os privilégios atribuídos por padrão ao token de processo. Se você especificar privilégios para um serviço, o SCM removerá os privilégios que não são necessários do token de processo quando o processo for iniciado. Se vários serviços compartilharem um processo, o SCM calculará a união de privilégios exigidos por todos os serviços no processo.

Para compatibilidade, o privilégio SeChangeNotifyPrivilege nunca é removido de um token de processo, mesmo que nenhum serviço no processo tenha solicitado o privilégio. Portanto, um serviço não precisa especificar explicitamente esse privilégio.

Observação

O cabeçalho winsvc.h define SERVICE_REQUIRED_PRIVILEGES_INFO 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 Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winsvc.h (incluir Windows.h)

Confira também

ChangeServiceConfig2

QueryServiceConfig2