Função AuthzInitializeContextFromSid (authz.h)

A função AuthzInitializeContextFromSid cria um contexto de cliente no modo de usuário de um SID ( identificador de segurança do usuário). SIDs de domínio recuperam atributos de grupo de tokens do Active Directory.

Sintaxe

AUTHZAPI BOOL AuthzInitializeContextFromSid(
  [in]           DWORD                         Flags,
  [in]           PSID                          UserSid,
  [in, optional] AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
  [in]           PLARGE_INTEGER                pExpirationTime,
  [in]           LUID                          Identifier,
  [in, optional] PVOID                         DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE  phAuthzClientContext
);

Parâmetros

[in] Flags

Os sinalizadores a seguir são definidos.

Começando com Windows 8 e Windows Server 2012, quando você chama essa função em um identificador de contexto remoto, os 16 bits superiores devem ser zero.

[in] UserSid

O SID do usuário para o qual um contexto de cliente será criado. Deve ser uma conta de usuário ou computador válida, a menos que o sinalizador AUTHZ_SKIP_TOKEN_GROUPS seja usado.

[in, optional] hAuthzResourceManager

Um identificador para o gerenciador de recursos que cria esse contexto de cliente. Esse identificador é armazenado na estrutura de contexto do cliente.

Começando com Windows 8 e Windows Server 2012, o gerenciador de recursos pode ser local ou remoto e é obtido chamando a função AuthzInitializeRemoteResourceManager.

[in] pExpirationTime

Data e hora de validade do token. Se nenhum valor for passado, o token nunca expirará. O tempo de expiração não é imposto no momento.

[in] Identifier

Identificador específico do gerenciador de recursos. Esse parâmetro não é usado no momento.

[in, optional] DynamicGroupArgs

Um ponteiro para parâmetros a serem passados para a função de retorno de chamada que calcula grupos dinâmicos. Esse parâmetro poderá ser NULL se nenhum parâmetro dinâmico for passado para a função de retorno de chamada.

Começando com Windows 8 e Windows Server 2012, esse parâmetro deverá ser NULL se o gerenciador de recursos for remoto. Caso contrário, ERROR_NOT_SUPPORTED será definido.

[out] phAuthzClientContext

Um ponteiro para o identificador para o contexto do cliente que a função AuthzInitializeContextFromSid cria. Quando terminar de usar o identificador, libere-o chamando a função AuthzFreeContext .

Retornar valor

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se possível, chame a função AuthzInitializeContextFromToken em vez de AuthzInitializeContextFromSid. AuthzInitializeContextFromSid tenta recuperar as informações disponíveis em um token de logon em que o cliente realmente fez logon. Um token de logon real fornece mais informações, como o tipo de logon e as propriedades de logon, e reflete o comportamento do pacote de autenticação usado para o logon. O contexto do cliente criado por AuthzInitializeContextFromToken usa um token de logon e o contexto do cliente resultante é mais completo e preciso do que um contexto de cliente criado por AuthzInitializeContextFromSid.

Essa função resolve apenas SIDs de usuário válidos.

Windows XP: Essa função resolve associações de grupo para SIDs de usuário e grupo válidos (a menos que o sinalizador AUTHZ_SKIP_TOKEN_GROUPS seja usado). O suporte para resolver associações de SIDs de grupo pode ser alterado ou indisponível em versões subsequentes.

Essa função chama a função de retorno de chamada AuthzComputeGroupsCallback para adicionar SIDs ao contexto recém-criado.

Requisitos

Confira também

Permitindo acesso anônimo

AuthzFreeContext

Funções de Controle de Acesso básicas