Compartir a través de


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