IX509CertificateTemplateWritable::Metode penerapan (certenroll.h)

Artikel
02/26/2024

Metode Penerapan menghapus templat dari atau menyimpannya ke Direktori Aktif.

Sintaks

HRESULT Commit(
  [in] CommitTemplateFlags commitFlags,
  [in] BSTR                strServerContext
);

Parameter

[in] commitFlags

Nilai enumerasi CommitTemplateFlags yang menentukan cara menyimpan atau menghapus templat. Ini harus menjadi salah satu nilai berikut.

Nilai	Makna
CommitFlagSaveTemplateGenerateOID	Simpan templat dan buat pengidentifikasi objek untuk templat tersebut.
CommitFlagSaveTemplateUseCurrentOID	Tidak digunakan.
CommitFlagSaveTemplateOverwrite	Tidak digunakan.
CommitFlagDeleteTemplate	Hapus templat.

[in] strServerContext

Variabel BSTR yang berisi nama DNS server Direktori Aktif tempat perubahan akan diterapkan. Jika nilai ini NULL, perubahan akan diterapkan ke pengendali domain default.

Menampilkan 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.

Menampilkan kode	Deskripsi
CRYPT_E_EXISTS	CommitFlagSaveTemplateGenerateOID ditentukan dalam argumen commitFlags tetapi templat dengan nama umum yang cocok atau pengidentifikasi objek yang cocok (OID) sudah ada.
CRYPT_E_NOT_FOUND	CommitFlagDelete ditentukan dalam argumen commitFlags dan templat dengan Nama Umum yang sama ditemukan tetapi OID tidak cocok.
E_ACCESSDEINED	Pemanggil tidak memiliki izin yang sesuai untuk menyimpan atau menghapus templat. Pemanggil harus memiliki izin tulis dan hapus pada kontainer templat dan objek templat di Direktori Aktif. Jika pemanggil memiliki izin hapus pada kontainer templat dan objek tetapi tidak memiliki izin penghapusan pada kontainer dan objek OID, templat akan dihapus tetapi OID tidak akan.
E_NOTIMPL	CommitFlagSaveTemplateUseCurrentOID atau CommitFlagSaveTemplateOverwrite ditentukan dalam argumen commitFlags. Nilai-nilai ini saat ini tidak digunakan.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	CommitFlagDelete ditentukan dalam argumen commitFlags tetapi templat yang memiliki Nama Umum (CN) yang cocok tidak dapat ditemukan.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Metode Penerapan tidak didukung untuk templat default.
OLE_E_BLANK	Objek IX509CertificateTemplateWritable belum diinisialisasi.

Keterangan

Ketika CommitFlagSaveTemplateGenerateOID ditentukan dalam argumen commitFlags , metode ini tidak akan berhasil kecuali templat dan kontainer OID telah dibuat. Kontainer ini dapat dibuat dengan salah satu cara berikut:

Menginstal otoritas sertifikasi perusahaan di server.
Meluncurkan Snap-in Certtmpl.msc.
Menggunakan perintah Certutil.exe -installDefaultTemplates untuk menginstal templat default.

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	certenroll.h

Lihat juga

IX509CertificateTemplateWritable

Bagikan melalui