Compartilhar via


Função IsTokenRestricted (securitybaseapi.h)

A função IsTokenRestricted indica se um token contém uma lista de SIDs ( identificadores de segurança restritos).

Sintaxe

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

Parâmetros

[in] TokenHandle

Um identificador para um token de acesso a ser testado.

Retornar valor

Se o token contiver uma lista de SIDs restritos, o valor retornado não será zero.

Se o token não contiver uma lista de SIDs restritos, o valor retornado será zero.

Se ocorrer um erro, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função CreateRestrictedToken pode restringir um token desabilitando SIDs, excluindo privilégios e especificando uma lista de SIDs restritos. A função IsTokenRestricted verifica apenas a lista de SIDs restritos. Se um token não tiver sids restritivos, IsTokenRestricted retornará FALSE, mesmo que o token tenha sido criado por uma chamada para CreateRestrictedToken.

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]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Visão geral do Controle de Acesso

Funções de Controle de Acesso básicas

Createrestrictedtoken