Metode ICspInformation::GetCspStatusFromOperations (certenroll.h)
Metode GetCspStatusFromOperations membuat objek ICspStatus untuk algoritma pertama yang didukung yang konsisten dengan operasi tanda tangan, enkripsi, hashing, atau cipher yang ditentukan.
Sintaks
HRESULT GetCspStatusFromOperations(
[in, optional] IObjectId *pAlgorithm,
[in] AlgorithmOperationFlags Operations,
[out] ICspStatus **ppValue
);
Parameter
[in, optional] pAlgorithm
Penunjuk ke antarmuka IObjectId yang mewakili OID algoritma. Parameter ini bersifat opsional dan dapat berupa NULL.
- Jika Anda menentukan OID dan mengatur parameter Operasi ke XCN_NCRYPT_SIGNATURE_OPERATION dan menggabungkan bendera ini dengan XCN_NCRYPT_EXACT_MATCH_OPERATION atau XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, algoritma tanda tangan pertama, jika ada, yang cocok dengan OID yang digunakan.
- Jika Anda menentukan OID tetapi tidak mengatur parameter Operasi ke XCN_NCRYPT_SIGNATURE_OPERATION, atau Anda mengatur XCN_NCRYPT_SIGNATURE_OPERATION tetapi tidak menggabungkannya dengan XCN_NCRYPT_EXACT_MATCH_OPERATION atau XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION, algoritma pertama yang dapat digunakan untuk penandatanganan atau enkripsi digunakan.
- Jika Anda tidak menentukan OID, algoritma pertama yang didukung konsisten dengan bendera yang ditentukan dalam parameter Operasi digunakan.
[in] Operations
Nilai enumerasi AlgoritmaOperationFlags yang mengidentifikasi jenis algoritma yang akan diambil. Salah satu nilai berikut harus ditentukan:
- XCN_NCRYPT_CIPHER_OPERATION
- XCN_NCRYPT_HASH_OPERATION
- XCN_NCRYPT_SIGNATURE_OPERATION
- XCN_NCRYPT_SECRET_AGREEMENT_OPERATION
- XCN_NCRYPT_ASYMMETRIC_ENCRYPTION_OPERATION
Anda dapat memperbaiki karakteristik pencarian dengan menggabungkan salah satu bendera sebelumnya dengan salah satu hal berikut:
- XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION
- XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION
- XCN_NCRYPT_EXACT_MATCH_OPERATION
Jika Anda mengatur bendera preferensi XCN_NCRYPT_PREFER_SIGNATURE_ONLY_OPERATION atau XCN_NCRYPT_PREFER_NON_SIGNATURE_OPERATION, Anda juga tidak dapat menentukan salah satu hal berikut:
- XCN_NCRYPT_CIPHER_OPERATION
- XCN_NCRYPT_HASH_OPERATION
[out] ppValue
Alamat variabel yang menerima penunjuk ke antarmuka ICspStatus .
Mengembalikan nilai
Jika fungsi berhasil, fungsi akan mengembalikan S_OK.
Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Objek ICspStatus tidak dapat ditemukan. |
|
Objek ICspInformation belum diinisialisasi. |
Keterangan
Objek ICspStatus berisi informasi status tentang penyedia kriptografi. Setiap objek diinisialisasi untuk algoritma tertentu yang didukung oleh penyedia. Jika Anda tidak menentukan algoritma dalam parameter pAlgorithm , algoritma pertama yang didukung yang konsisten dengan operasi yang diizinkan dipilih untuk membuat objek ICspStatus .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | certenroll.h |
DLL | CertEnroll.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk