Fungsi NCryptQueryProtectionDescriptorName (ncryptprotect.h)

Artikel
03/15/2023

Fungsi NCryptQueryProtectionDescriptorName mengambil string aturan deskriptor perlindungan yang terkait dengan nama tampilan deskriptor terdaftar.

Sintaks

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

Parameter

[in] pwszName

Nama tampilan terdaftar untuk deskriptor perlindungan. Daftarkan nama dengan memanggil fungsi NCryptRegisterProtectionDescriptorName .

[out] pwszDescriptorString

String Unicode yang dihentikan null yang berisi aturan deskriptor perlindungan. Atur nilai ini ke NULL dan atur ukuran string deskriptor yang ditunjukkan oleh argumen pcDescriptorString ke nol pada panggilan awal Anda ke fungsi ini. Untuk informasi selengkapnya, lihat Keterangan.

[in, out] pcDescriptorString

Penunjuk ke variabel yang berisi jumlah karakter dalam string yang diambil dalam parameter pwszDescriptorString . Atur variabel ke nol pada panggilan awal Anda ke fungsi ini. Untuk informasi selengkapnya, lihat Keterangan.

dwFlags

Bendera yang menentukan sarang registri mana yang akan dikueri untuk nama terdaftar. Ini bisa nol untuk dilihat di sarang HKEY_CURRENT_USER atau Anda bisa menentukan NCRYPT_MACHINE_KEY_FLAG untuk mengkueri sarang HKEY_LOCAL_MACHINE .

Mengembalikan nilai

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi. Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
ERROR_SUCCESS	Fungsi berhasil.
NTE_INVALID_PARAMETER	Parameter pwszName tidak boleh NULL, dan nilai yang diarahkan oleh parameter tidak boleh berupa string kosong.
NTE_BAD_FLAGS	Parameter dwFlags harus nol atau NCRYPT_MACHINE_KEY_FLAG.

Keterangan

Untuk mengambil string aturan deskriptor perlindungan, Anda harus memanggil fungsi ini dua kali. Pertama kali Anda memanggil, atur argumen pwszDescriptorString ke NULL dan nilai yang diarahkan oleh argumen pcDescriptorString ke nol. Panggilan pertama Anda mengambil jumlah karakter dalam string deskriptor. Gunakan nomor ini untuk mengalokasikan memori untuk string dan mengambil pointer ke buffer yang dialokasikan. Untuk mengambil string, panggil fungsi lagi menggunakan penunjuk.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	ncryptprotect.h
Pustaka	NCrypt.lib
DLL	NCrypt.dll

Lihat juga

Fungsi CNG DPAPI

NCryptRegisterProtectionDescriptorName

Bagikan melalui