Función DrtCreateDerivedKey (drt.h)

La función DrtCreateDerivedKey crea una clave que DrtRegisterKey puede usar cuando drtRegisterKey usa un proveedor de seguridad de clave derivada.

Sintaxis

HRESULT DrtCreateDerivedKey(
  [in]  PCCERT_CONTEXT pLocalCert,
  [out] DRT_DATA       *pKey
);

Parámetros

[in] pLocalCert

Puntero al certificado que es la parte "local" de la cadena. La raíz de esta cadena debe coincidir con la raíz especificada por pRootCert en DrtCreateDerivedKeySecurityProvider. Este certificado se usa para generar una clave que se usa para registrar y demostrar la "propiedad de la clave" con el DRT.

[out] pKey

Puntero a la clave creada.

Valor devuelto

Esta función devuelve S_OK si se ejecuta correctamente. Otros valores posibles son:

Código devuelto Descripción
E_INVALIDARG
  • pLocalCert es NULL.
  • pKey es NULL.
  • El miembro pb de la estructura DRT_DATA es NULL.
  • El miembro cb de la estructura DRT_DATA no es igual a 32 bytes.
DRT_E_CAPABILITY_MISMATCH
  • Los algoritmos de seguridad solicitados no están disponibles ( es decir, . BCRYPT_SHA256_ALGORITHM o BCRYPT_AES_ALGORITHM).
  • Error en la operación BCryptOpenAlgorithmProvider .
  • El parámetro dwProvType indica que el proveedor de certificados no es compatible con AES.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado drt.h
Library Drtprov.lib
Archivo DLL Drt.dll

Consulte también

DrtCreateDerivedKeySecurityProvider

DrtDeleteDerivedKeySecurityProvider

DrtRegisterKey