Función CryptReleaseContext (wincrypt.h)

La función CryptReleaseContext libera el identificador de un proveedor de servicios criptográficos (CSP) y un contenedor de claves. En cada llamada a esta función, el recuento de referencias del CSP se reduce en uno. Cuando el recuento de referencias alcanza cero, el contexto se libera por completo y ya no se puede usar en ninguna función de la aplicación.

Una aplicación llama a esta función después de finalizar el uso del CSP. Después de llamar a esta función, el identificador de CSP liberado ya no es válido. Esta función no destruye los contenedores de claves ni los pares de claves.

Sintaxis

BOOL CryptReleaseContext(
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwFlags
);

Parámetros

[in] hProv

Identificador de un proveedor de servicios criptográficos (CSP) creado por una llamada a CryptAcquireContext.

[in] dwFlags

Reservado para uso futuro y debe ser cero. Si dwFlags no se establece en cero, esta función devuelve FALSE , pero se libera el CSP.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero (TRUE).

Si se produce un error en la función, el valor devuelto es cero (FALSE). Para obtener información de error extendida, llame a GetLastError. Algunos códigos de error posibles se enumeran en la tabla siguiente.

Código devuelto	Descripción
ERROR_BUSY	Otro proceso está usando el contexto de CSP especificado por hProv.
ERROR_INVALID_HANDLE	Uno de los parámetros especifica un identificador que no es válido.
ERROR_INVALID_PARAMETER	Uno de los parámetros contiene un valor que no es válido. Suele ser un puntero que no es válido.
NTE_BAD_FLAGS	El parámetro dwFlags es distinto de cero.
NTE_BAD_UID	El parámetro hProv no contiene un identificador de contexto válido.

Comentarios

Después de llamar a esta función, la sesión de CSP ha finalizado y todas las claves de sesión y los objetos hash existentes creados mediante el identificador hProv ya no son válidos. En la práctica, todos estos objetos deben destruirse con llamadas a CryptDestroyKey y CryptDestroyHash antes de llamar a CryptReleaseContext .

Ejemplos

Para obtener un ejemplo que usa esta función, vea Ejemplo de programa C: Creación y hash de una clave de sesión.

Requisitos

Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

CryptAcquireContext

CryptDestroyHash

CryptDestroyKey

Funciones del proveedor de servicios