Função ExportSecurityContext (sspi.h)

  • Artigo

A função ExportSecurityContext cria uma representação serializada de um contexto de segurança que posteriormente pode ser importado para um processo diferente chamando
ImportSecurityContext. O processo que importa o contexto de segurança deve estar em execução no mesmo computador que o processo chamado ExportSecurityContext.

Sintaxe

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Parâmetros

[in] phContext

Um identificador do contexto de segurança a ser exportado.

[in] fFlags

Esse parâmetro pode ser uma combinação or bit a bit dos valores a seguir.

Valor Significado
SECPKG_CONTEXT_EXPORT_RESET_NEW
1 (0x1)
 O novo contexto de segurança é redefinido para seu estado inicial.
SECPKG_CONTEXT_EXPORT_DELETE_OLD
2 (0x2)
 O contexto de segurança antigo é excluído.
SECPKG_CONTEXT_EXPORT_TO_KERNEL
4 (0x4)
 Não há suporte para esse valor.

Windows Server 2003 e Windows XP/2000: O contexto de segurança deve ser exportado para o kernel. Esse valor só tem suporte no modo kernel Schannel.

[out] pPackedContext

Um ponteiro para um buffer do tipo SECBUFFER_EMPTY que recebe o contexto de segurança serializado . Quando terminar de usar esse contexto, libere-o chamando a função FreeContextBuffer .

[out, optional] pToken

Um ponteiro para receber o identificador do token do contexto.

Quando terminar de usar o token de usuário, libere o identificador chamando a função CloseHandle .

Retornar valor

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

Se a função falhar, ela retornará um dos seguintes códigos de erro.

Código de retorno Descrição
SEC_E_INSUFFICIENT_MEMORY
 Não há memória suficiente disponível para concluir a ação solicitada.
SEC_E_INVALID_HANDLE
 O parâmetro phContext não aponta para um identificador válido.
SEC_E_NOT_SUPPORTED
 O modo kernel Schannel não dá suporte a essa função.

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 sspi.h (inclua Security.h)
Biblioteca Secur32.lib
DLL Secur32.dll

Confira também

Freecontextbuffer

ImportSecurityContext

Funções SSPI