IOpcCertificateEnumerator::GetCurrent method (msopc.h)

Artikel
11/11/2023

Mendapatkan struktur CERT_CONTEXT pada posisi enumerator saat ini.

Sintaks

HRESULT GetCurrent(
  [out, retval] const CERT_CONTEXT **certificate
);

Parameter

[out, retval] certificate

Penunjuk ke struktur CERT_CONTEXT . Jika metode berhasil, panggil fungsi CertFreeCertificateContext untuk membebaskan memori struktur.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Mengembalikan kode/nilai	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter partReference adalah NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	Enumerator tidak valid karena set yang mendasar telah berubah.
OPC_E_ENUM_INVALID_POSITION 0x80510053	Enumerator tidak dapat melakukan operasi ini dari posisinya saat ini.
OPC_E_DS_EXTERNAL_SIGNATURE 0x8051001E	Hubungan yang targetnya adalah bagian Tanda Tangan memiliki mode target eksternal; Bagian tanda tangan harus berada di dalam paket.
OPC_E_DS_INVALID_CERTIFICATE_RELATIONSHIP 0x8051001D	Hubungan jenis sertifikat tanda tangan digital memiliki mode target eksternal. Untuk informasi selengkapnya tentang jenis hubungan ini, lihat OPC.
OPC_E_DS_INVALID_RELATIONSHIP_TRANSFORM_XML 0x80510021	Elemen Transformasi yang menunjukkan penggunaan transformasi hubungan dan kriteria pemilihan untuk transformasi tidak sesuai dengan skema yang ditentukan dalam OPC.
OPC_E_DS_MISSING_CERTIFICATE_PART 0x80510056	Bagian yang berisi sertifikat dan merupakan target hubungan tipe sertifikat tanda tangan digital tidak ada. Untuk informasi selengkapnya tentang jenis hubungan ini, lihat OPC.
OPC_E_DS_SIGNATURE_PROPERTY_MISSING_TARGET 0x80510045	Elemen SignatureProperty tidak memiliki atribut Target yang diperlukan.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Jenis konten bagian yang berbeda dari jenis konten yang diharapkan (ditentukan dalam OPC, ECMA-376 Bagian 2), atau konten bagian tidak cocok dengan jenis konten bagian.

Keterangan

Jika sertifikat yang diwakili oleh struktur CERT_CONTEXT rusak atau bukan sertifikat X.509, metode ini akan mengembalikan kesalahan; selanjutnya, kebijakan penandatanganan yang digunakan oleh pemanggil menentukan apakah tanda tangan masih akan divalidasi. Setelah kesalahan semacam ini dikembalikan, panggilan ke metode MoveNext atau MovePrevious akan terus melakukan iterasi melalui enumerator.

Ketika enumerator dibuat, posisi saat ini mendahului penunjuk pertama enumerator. Untuk mengatur posisi saat ini ke penunjuk pertama, panggil metode MoveNext setelah enumerator dibuat.

Keamanan Thread

Objek pengemasan tidak aman untuk utas.

Untuk informasi selengkapnya, lihat Memulai PACKAGING API.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h