Función ExportSecurityContext (sspi.h)

La función ExportSecurityContext crea una representación serializada de un contexto de seguridad que posteriormente se puede importar en un proceso diferente mediante una llamada a .
ImportSecurityContext. El proceso que importa el contexto de seguridad debe ejecutarse en el mismo equipo que el proceso que llamó a ExportSecurityContext.

Sintaxis

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

Parámetros

[in] phContext

Identificador del contexto de seguridad que se va a exportar.

[in] fFlags

Este parámetro puede ser una combinación or bit a bit de los valores siguientes.

Valor	Significado
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	El nuevo contexto de seguridad se restablece a su estado inicial.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	Se elimina el contexto de seguridad anterior.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Este valor no se admite. Windows Server 2003 y Windows XP/2000: El contexto de seguridad se va a exportar al kernel. Este valor solo se admite en el modo kernel de Schannel.

[out] pPackedContext

Puntero a un búfer de tipo SECBUFFER_EMPTY que recibe el contexto de seguridad serializado . Cuando haya terminado de usar este contexto, puede liberarlo llamando a la función FreeContextBuffer .

[out, optional] pToken

Puntero para recibir el identificador del token del contexto.

Cuando haya terminado de usar el token de usuario, libere el identificador llamando a la función CloseHandle .

Valor devuelto

Si la función se realiza correctamente, la función devuelve SEC_E_OK.

Si se produce un error en la función, devuelve uno de los siguientes códigos de error.

Código devuelto	Descripción
SEC_E_INSUFFICIENT_MEMORY	No hay suficiente memoria disponible para completar la acción solicitada.
SEC_E_INVALID_HANDLE	El parámetro phContext no apunta a un identificador válido.
SEC_E_NOT_SUPPORTED	El modo kernel de Schannel no admite esta función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	sspi.h (include Security.h)
Library	Secur32.lib
Archivo DLL	Secur32.dll

Consulte también

FreeContextBuffer

ImportSecurityContext

Funciones SSPI