Compartir a través de

Función SspiEncryptAuthIdentityEx (sspi.h)

  • Artículo

Cifra una estructura de SEC_WINNT_AUTH_IDENTITY_OPAQUE .

Sintaxis

SECURITY_STATUS SEC_ENTRY SspiEncryptAuthIdentityEx(
  [in]      ULONG                           Options,
  [in, out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE AuthData
);

Parámetros

[in] Options

Opciones de cifrado. Puede ser uno o varios de los valores siguientes.

Valor Significado
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON
 La estructura cifrada solo se puede descifrar mediante un contexto de seguridad en la misma sesión de inicio de sesión. Esta opción se usa para proteger un búfer de identidad que se envía a través de una RPC local.
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS
 La estructura cifrada solo se puede descifrar mediante el mismo proceso. Llamar a la función con esta opción equivale a llamar a SspiEncryptAuthIdentity. Esta opción se usa para proteger un búfer de identidad que se conserva en la memoria privada de un proceso durante un período prolongado.

[in, out] AuthData

En la entrada, un puntero a un búfer de identidad que se va a cifrar. Este búfer debe estar preparado para el cifrado antes de la llamada a esta función. Para ello, llame a la función SspiEncryptAuthIdentity. En la salida, el búfer de identidad cifrado.

Valor devuelto

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

Si se produce un error en la función, devuelve un código de error distinto de cero.

Comentarios

Para transferir credenciales de forma segura entre procesos, las aplicaciones suelen llamar a esta función con la opción SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON, seguida de SspiMarshalAuthIdentity para obtener un búfer de autenticación serializado y su longitud. Por ejemplo, El proveedor de credenciales de identidad en línea hace esto para devolver el búfer de autenticación desde su método ICredentialProviderCredential::GetSerialization .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado sspi.h