DrtRegisterKey-Funktion (drt.h)

  • Artikel

Die DrtRegisterKey-Funktion registriert einen Schlüssel im DRT.

Syntax

HRESULT DrtRegisterKey(
  [in]           HDRT                      hDrt,
  [in]           DRT_REGISTRATION          *pRegistration,
  [in, optional] PVOID                     pvKeyContext,
  [out]          HDRT_REGISTRATION_CONTEXT *phKeyRegistration
);

Parameter

[in] hDrt

Ein Zeiger auf ein Handle, das von der DrtOpen-Funktion zurückgegeben wird.

[in] pRegistration

Ein Zeiger auf ein Handle auf die DRT_REGISTRATION-Struktur .

[in, optional] pvKeyContext

Zeiger auf die Kontextdaten, die dem Schlüssel im DRT zugeordnet sind. Diese Daten werden an die schlüsselspezifischen Funktionen des Sicherheitsanbieters übergeben.

[out] phKeyRegistration

Zeiger auf ein Handle für einen Schlüssel, der registriert wurde.

Rückgabewert

Diese Funktion gibt S_OK nach Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
E_INVALIDARG
E_HANDLE
 hDrt ist ein ungültiges Handle oder phKeyRegistration ist ein ungültiges Handle.
DRT_E_INVALID_KEY_SIZE
 Die Größe des cb-Werts des Schlüsselmembers der DRT_REGISTRATION-Struktur entspricht nicht 256 Bits, oder der pb-Wert des Schlüsselmembers der DRT_REGISTRATION-Struktur ist NULL..
DRT_E_FAULTED
 Die DRT-Cloud befindet sich im fehlerhaften Zustand.
DRT_E_DUPLICATE_KEY
 Der Schlüssel ist bereits registriert.
DRT_E_INVALID_CERT_CHAIN
 Die bereitgestellte Zertifizierungskette ist ungültig.
DRT_E_CAPABILITY_MISMATCH
 Der bereitgestellte Zertifikatanbieter ist nicht AES-fähig.
DRT_E_INVALID_KEY
 Der angegebene Schlüssel stimmt nicht mit dem generierten Schlüssel überein.
DRT_E_TRANSPORT_NO_DEST_ADDRESSES
 Gültige Adresse nicht gefunden.
DRT_E_TRANSPORT_SHUTTING_DOWN
 Der Transport wird heruntergefahren.
DRT_E_INVALID_TRANSPORT_PROVIDER
 Der Transportanbieter ist NULL.
DRT_E_TRANSPORTPROVIDER_NOT_ATTACHED
 Der Transport ist nicht angefügt.
DRT_E_SECURITYPROVIDER_NOT_ATTACHED
 Der Sicherheitsanbieter ist nicht angefügt.
DRT_E_TRANSPORT_NOT_BOUND
 Der Transport ist derzeit nicht gebunden.
E_OUTOFMEMORY
 Das System hat nicht genügend Arbeitsspeicher.
E_UNEXPECTED
  • GlobalControl.HandleTable ist NULL.
  • Die Cloud wird heruntergefahren.
  • Das DRT wird heruntergefahren.
E_FAIL
 Unerwarteter schwerwiegender Fehler.
 
HinweisDrtRegisterKey kann auch Fehler von zugrunde liegenden Aufrufen von CryptGetProvParam anzeigen, CertGetCertificateChain, CertOpenStore, CertAddCertificateContextToStore, CryptContextAddRef, CryptAcquireCertificatePrivateKey, CertSaveStore, WSAIoctl, CryptImportPublicKeyInfoEx2, NCryptSignHash, CertEnumCertificatesInStore, BCryptGetProperty, BCryptGenRandom, BCryptGenerateSymmetricKey und BCryptEncrypt.
 

Hinweise

Ein Knoten kann Schlüssel registrieren, während er sich im zustand DRT_ACTIVE, DRT_ALONE oder DRT_NO_NETWORK befindet. Schlüssel, die in DRT_ALONE - und DRT_NO_NETWORK-Zuständen registriert sind, können von anderen DRTs jedoch erst erkannt werden, nachdem der lokale Knoten zu DRT_ACTIVE gewechselt ist.

Um einen vorhandenen Schlüssel zu aktualisieren, muss eine Anwendung zuerst die Registrierung des Schlüssels mit DrtUnregisterKey aufheben, bevor DrtRegisterKey aufgerufen wird , um den aktualisierten Schlüssel zu registrieren.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile drt.h
Bibliothek Drt.lib
DLL Drt.dll

Weitere Informationen

DRT_REGISTRATION

DrtOpen

DrtUnregisterKey