Funzione DrtCreateDerivedKey (drt.h)

  • Articolo

La funzione DrtCreateDerivedKey crea una chiave che può essere utilizzata da DrtRegisterKey quando DRT usa un provider di sicurezza della chiave derivata.

Sintassi

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

Parametri

[in] pLocalCert

Puntatore al certificato che rappresenta la parte "locale" della catena. La radice di questa catena deve corrispondere alla radice specificata da pRootCert in DrtCreateDerivedKeySecurityProvider. Questo certificato viene usato per generare una chiave usata per registrare e dimostrare la "proprietà della chiave" con DRT.

[out] pKey

Puntatore alla chiave creata.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono:

Codice restituito Descrizione
E_INVALIDARG
  • pLocalCert è NULL.
  • pKey è NULL.
  • Il membro pb nella struttura DRT_DATA è NULL.
  • Il membro cb nella struttura DRT_DATA non è uguale a 32 byte.
DRT_E_CAPABILITY_MISMATCH
  • Gli algoritmi di sicurezza richiesti non sono disponibili ( ad esempio. BCRYPT_SHA256_ALGORITHM o BCRYPT_AES_ALGORITHM).
  • Operazione BCryptOpenAlgorithmProvider non riuscita.
  • Il parametro dwProvType indica che il provider di certificati non è in grado di supportare AES.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 Professional [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione drt.h
Libreria Drtprov.lib
DLL Drt.dll

Vedi anche

DrtCreateDerivedKeySecurityProvider

DrtDeleteDerivedKeySecurityProvider

DrtRegisterKey