Función BCryptDestroySecret (bcrypt.h)

  • Artículo

La función BCryptDestroySecret destruye un identificador de contrato secreto que se creó mediante la función BCryptSecretAgreement .

Sintaxis

NTSTATUS BCryptDestroySecret(
  [in] BCRYPT_SECRET_HANDLE hSecret
);

Parámetros

[in] hSecret

El BCRYPT_SECRET_HANDLE que se va a destruir.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los posibles códigos de retorno se incluyen, entre otros, los siguientes.

Código devuelto Descripción
STATUS_SUCCESS
 La función se realizó correctamente.
STATUS_INVALID_HANDLE
 El identificador del parámetro hSecret no es válido.

Comentarios

En función de los modos de procesador que admita un proveedor, se puede llamar a BCryptDestroySecret desde el modo de usuario o el modo kernel. Los autores de llamadas en modo kernel se pueden ejecutar en PASSIVE_LEVELIRQL o DISPATCH_LEVEL IRQL. Si el nivel de IRQL actual es DISPATCH_LEVEL, el identificador proporcionado en el parámetro hSecret debe derivarse de un identificador de algoritmo devuelto por un proveedor que se abrió mediante la marca BCRYPT_PROV_DISPATCH .

Para llamar a esta función en modo kernel, use Cng.lib, que forma parte del Kit de desarrollo de controladores (DDK). Windows Server 2008 y Windows Vista: Para llamar a esta función en modo kernel, use Ksecdd.lib.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado bcrypt.h
Library Bcrypt.lib
Archivo DLL Bcrypt.dll

Consulte también

BCryptSecretAgreement