Fungsi DrtRegisterKey (drt.h)

  • Artikel

Fungsi DrtRegisterKey mendaftarkan kunci di DRT.

Sintaks

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

Parameter

[in] hDrt

Penunjuk ke handel yang dikembalikan oleh fungsi DrtOpen .

[in] pRegistration

Penunjuk ke handel ke struktur DRT_REGISTRATION .

[in, optional] pvKeyContext

Arahkan ke data konteks yang terkait dengan kunci di DRT. Data ini diteruskan ke fungsi khusus kunci penyedia keamanan.

[out] phKeyRegistration

Penunjuk ke handel untuk kunci yang telah didaftarkan.

Menampilkan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk:

Menampilkan kode Deskripsi
E_INVALIDARG
  • pRegistration adalah NULL
  • Nilai cb anggota appData dari struktur DRT_REGISTRATION terlalu besar (yaitu kurang dari 1).
  • Nilai cb anggota appData dari struktur DRT_REGISTRATION terlalu besar (yaitu lebih dari 5120).
  • Nilai pb anggota kunci struktur DRT_REGISTRATION adalah NULL.
  • phKeyRegistration adalah NULL
E_HANDLE
 hDrt adalah handel yang tidak valid atau phKeyRegistration adalah handel yang tidak valid
DRT_E_INVALID_KEY_SIZE
 Ukuran nilai cb anggota kunci struktur DRT_REGISTRATION tidak sama dengan 256 bit atau nilai pb anggota kunci struktur DRT_REGISTRATION adalah NULL..
DRT_E_FAULTED
 Cloud DRT dalam keadaan rusak.
DRT_E_DUPLICATE_KEY
 Kunci sudah terdaftar.
DRT_E_INVALID_CERT_CHAIN
 Rantai sertifikasi yang disediakan tidak valid.
DRT_E_CAPABILITY_MISMATCH
 Penyedia sertifikat yang disediakan tidak mampu melakukan AES.
DRT_E_INVALID_KEY
 Kunci yang disediakan tidak cocok dengan kunci yang dihasilkan.
DRT_E_TRANSPORT_NO_DEST_ADDRESSES
 Alamat yang valid tidak ditemukan.
DRT_E_TRANSPORT_SHUTTING_DOWN
 Transportasi dimatikan.
DRT_E_INVALID_TRANSPORT_PROVIDER
 Penyedia transportasi adalah NULL.
DRT_E_TRANSPORTPROVIDER_NOT_ATTACHED
 Transportasi tidak terpasang.
DRT_E_SECURITYPROVIDER_NOT_ATTACHED
 Penyedia keamanan tidak terlampir.
DRT_E_TRANSPORT_NOT_BOUND
 Transportasi saat ini tidak terikat.
E_OUTOFMEMORY
 Sistem kehabisan memori.
E_UNEXPECTED
  • GlobalControl.HandleTable ADALAH NULL.
  • Cloud dimatikan.
  • DRT dimatikan.
E_FAIL
 Terjadi kesalahan fatal yang tidak terduga.
 
CatatanDrtRegisterKey juga dapat menampilkan kesalahan dari panggilan yang mendasari ke CryptGetProvParam, CertGetCertificateChain, CertOpenStore, CertAddCertificateContextToStore, CryptContextAddRef, CryptAcquireCertificatePrivateKey, CertSaveStore, WSAIoctl, CryptImportPublicKeyInfoEx2, NCryptSignHash, CertEnumCertificatesInStore, BCryptGetProperty, BCryptGenRandom, BCryptGenerateSymmetricKey dan BCryptEncrypt.
 

Keterangan

Simpul dapat mendaftarkan kunci saat berada dalam status DRT_ACTIVE, DRT_ALONE, atau DRT_NO_NETWORK . Namun, kunci yang terdaftar di status DRT_ALONE dan DRT_NO_NETWORK hanya dapat dikenali oleh DRT lain setelah simpul lokal beralih ke DRT_ACTIVE.

Untuk memperbarui kunci yang ada, aplikasi harus terlebih dahulu membatalkan pendaftaran kunci dengan DrtUnregisterKey sebelum memanggil DrtRegisterKey untuk mendaftarkan kunci yang diperbarui.

Persyaratan

   
Klien minimum yang didukung Windows 7 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header drt.h
Pustaka Drt.lib
DLL Drt.dll

Lihat juga

DRT_REGISTRATION

DrtBuka

DrtUnregisterKey