Compartilhar via


Função AuthzInitializeContextFromAuthzContext (authz.h)

A função AuthzInitializeContextFromAuthzContext cria um novo contexto de cliente com base em um contexto de cliente existente.

Começando com Windows Server 2012 e Windows 8, essa função também duplica grupos de dispositivos, declarações de usuário e declarações de dispositivo.

Sintaxe

AUTHZAPI BOOL AuthzInitializeContextFromAuthzContext(
  [in]           DWORD                        Flags,
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE  hAuthzClientContext,
  [in, optional] PLARGE_INTEGER               pExpirationTime,
  [in]           LUID                         Identifier,
  [in]           PVOID                        DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);

Parâmetros

[in] Flags

Reservado para uso futuro.

[in] hAuthzClientContext

O identificador para um contexto de cliente existente.

[in, optional] pExpirationTime

Define o limite de tempo para quanto tempo a estrutura de contexto retornada é válida. Se nenhum valor for passado, o token nunca expirará. O tempo de expiração não é imposto no momento.

[in] Identifier

O identificador específico para o gerenciador de recursos.

[in] DynamicGroupArgs

Um ponteiro para parâmetros a serem passados para a função de retorno de chamada que calcula grupos dinâmicos. Se o valor for NULL, a função de retorno de chamada não será chamada.

[out] phNewAuthzClientContext

Um ponteiro para o identificador de AUTHZ_CLIENT_CONTEXT_HANDLE duplicado. Quando terminar de usar o identificador, solte-o chamando a função AuthzFreeContext .

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

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

Comentários

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

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 authz.h
Biblioteca Authz.lib
DLL Authz.dll
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AUTHZ_ACCESS_REPLY

Funções de Controle de Acesso básicas