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 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) |