Bagikan melalui

Metode ICspInformation::GetCspStatusFromOperations (certenroll.h)

  • Artikel

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
CERTSRV_E_PROPERTY_EMPTY
 Objek ICspStatus tidak dapat ditemukan.
OLE_E_BLANK
 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

ICspInformation