estrutura SERVICE_REQUIRED_PRIVILEGES_INFOA (winsvc.h)
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 Privilege Constants.
Uma cadeia de caracteres múltipla é uma sequência de cadeias de caracteres terminadas em nulo, encerradas por uma cadeia de caracteres vazia (\0). Veja a seguir um exemplo: String1\0String2\0String3\0LastString\0\0.
Observações
A alteração nos privilégios necessários entra 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 exigida 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.
Nota
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 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 Vista [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2008 [somente aplicativos da área de trabalho] |
| cabeçalho | winsvc.h (incluir Windows.h) |
Consulte também