Função de retorno de chamada SpGetContextTokenFn (ntsecpkg.h)

  • Artigo

Obtém o token a ser representado. A função SpGetContextToken é usada pela função ImpersonateSecurityContext do SSPI para obter o token a ser representado.

Sintaxe

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

Parâmetros

[in] ContextHandle

Um identificador para o contexto a ser representado.

[out] ImpersonationToken

Ponteiro que recebe um identificador para o token para o contexto especificado. Retorne o identificador para o token sem primeiro duplicar o identificador ou o token.

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou. O exemplo a seguir lista um motivo comum para a falha e o código de erro que a função deve retornar.

Código de retorno Descrição
SEC_E_INVALID_HANDLE
 O identificador não é válido.

Comentários

SSP/APs devem implementar a função SpGetContextToken ; no entanto, o nome real fornecido à implementação cabe ao desenvolvedor.

Um ponteiro para a função SpGetContextToken está disponível na estrutura SECPKG_USER_FUNCTION_TABLE recebida da função SpUserModeInitialize .

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 ntsecpkg.h

Confira também

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize