Método IAzApplication2::InitializeClientContextFromToken2 (azroles.h)

  • Artigo

O método InitializeClientContextFromToken2 recupera um ponteiro de objeto IAzClientContext2 do token de cliente especificado.

Sintaxe

HRESULT InitializeClientContextFromToken2(
  [in]           ULONG             ulTokenHandleLowPart,
  [in]           ULONG             ulTokenHandleHighPart,
  [in, optional] VARIANT           varReserved,
  [out]          IAzClientContext2 **ppClientContext
);

Parâmetros

[in] ulTokenHandleLowPart

Byte baixo de um identificador para um token que especifica o cliente. Se os valores desse parâmetro e do parâmetro ulTokenHandleHighPart forem zero, o token de representação do thread do chamador será usado. Se o thread não tiver um token de representação, o token de processo será usado. O token deve ter sido aberto para acesso TOKEN_QUERY, TOKEN_IMPERSONATE ou TOKEN_DUPLICATE.

[in] ulTokenHandleHighPart

Byte alto de um identificador para um token que especifica o cliente. Se os valores desse parâmetro e do parâmetro ulTokenHandleHighPart forem zero, o token de representação do thread do chamador será usado. Se o thread não tiver um token de representação, o token de processo será usado. O token deve ter sido aberto para acesso TOKEN_QUERY, TOKEN_IMPERSONATE ou TOKEN_DUPLICATE.

[in, optional] varReserved

Reservado para uso futuro.

[out] ppClientContext

Um ponteiro para um ponteiro para o objeto IAzClientContext2 retornado.

Retornar valor

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008, Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho azroles.h
Biblioteca Azroles.lib
DLL Azroles.dll
Redistribuível Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP