Função ExportSecurityContext (sspi.h)

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