Función ImportSecurityContextW (sspi.h)

  • Artículo

La función ImportSecurityContext importa un contexto de seguridad. El contexto de seguridad debe haberse exportado al proceso que llama a ImportSecurityContext mediante una llamada anterior a ExportSecurityContext.

Sintaxis

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ImportSecurityContextW(
  [in]           PSECURITY_STRING pszPackage,
  [in]           PSecBuffer       pPackedContext,
  [in, optional] void             *Token,
  [out]          PCtxtHandle      phContext
);

Parámetros

[in] pszPackage

Cadena que contiene el nombre del paquete de seguridad al que se exportó el contexto de seguridad .

[in] pPackedContext

Puntero a un búfer que contiene el contexto de seguridad serializado creado por ExportSecurityContext.

[in, optional] Token

Identificador del token del contexto.

[out] phContext

Identificador del nuevo contexto de seguridad creado a partir de pPackedContext. Cuando haya terminado de usar el contexto, elimínelo llamando a la función DeleteSecurityContext .

Valor devuelto

Si la función se ejecuta 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_UNKNOWN_CREDENTIALS
 No se han reconocido las credenciales proporcionadas al paquete.
SEC_E_NO_CREDENTIALS
 No hay credenciales disponibles en el paquete de seguridad.
SEC_E_NOT_OWNER
 El autor de la llamada de la función no tiene las credenciales necesarias.
SEC_E_INSUFFICIENT_MEMORY
 No hay suficiente memoria disponible para completar la acción solicitada.
SEC_E_INTERNAL_ERROR
 Error que no se asignación a un código de error de SSPI.

Comentarios

Nota

El encabezado sspi.h define ImportSecurityContext como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de 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

ExportSecurityContext

FreeContextBuffer

Funciones SSPI