Fungsi CryptGetObjectUrl (wincrypt.h)

Artikel
08/27/2023

Fungsi CryptGetObjectUrl memperoleh URL objek jarak jauh dari sertifikat, daftar kepercayaan sertifikat (CTL), atau daftar pencabutan sertifikat (CRL).

Fungsi mengambil objek , mendekodenya, dan menyediakan penunjuk ke array URL dari objek . Misalnya, dari sertifikat, daftar distribusi URL CRL akan berada dalam array.

Sintaks

BOOL CryptGetObjectUrl(
  [in]      LPCSTR           pszUrlOid,
  [in]      LPVOID           pvPara,
  [in]      DWORD            dwFlags,
  [out]     PCRYPT_URL_ARRAY pUrlArray,
  [in, out] DWORD            *pcbUrlArray,
  [out]     PCRYPT_URL_INFO  pUrlInfo,
  [in, out] DWORD            *pcbUrlInfo,
            LPVOID           pvReserved
);

Parameter

[in] pszUrlOid

Penunjuk ke pengidentifikasi objek (OID) yang mengidentifikasi URL yang diminta. Jika HIWORD parameter pszUrlOid adalah nol , LOWORD menentukan pengidentifikasi bilangan bulat untuk jenis struktur yang ditentukan.

Parameter ini bisa menjadi salah satu nilai berikut. Untuk informasi tentang bagaimana nilai-nilai ini memengaruhi parameter pvPara , lihat judul "Untuk parameter pvPara " di kolom Arti .

Nilai	Makna
URL_OID_CERTIFICATE_ISSUER	Menyediakan URL penerbit sertifikat yang diambil dari ekstensi akses informasi otoritas atau properti sertifikat. Untuk parameter pvPara : Pointer ke struktur CERT_CONTEXT yang dikeluarkan oleh penerbit yang URL-nya sedang diminta.
URL_OID_CERTIFICATE_CRL_DIST_POINT	Menyediakan daftar URL titik distribusi CRL yang diambil dari ekstensi titik distribusi CRL atau properti sertifikat. Untuk parameter pvPara : Pointer ke struktur CERT_CONTEXT yang titik distribusi CRL-nya diminta.
URL_OID_CERTIFICATE_CRL_DIST_POINT_AND_OCSP	Menyediakan daftar URL titik distribusi OCSP dan CRL dari akses informasi otoritas (AIA) dan ekstensi titik distribusi CRL atau properti sertifikat. Fungsi mengembalikan URL titik distribusi CRL terlebih dahulu. Sebelum menggunakan URL OCSP apa pun, Anda harus menghapus awalan L"ocsp:". Untuk parameter pvPara : Pointer ke struktur CERT_CONTEXT yang URL titik distribusi OCSP dan CRL-nya diminta.
URL_OID_CERTIFICATE_OCSP	Menyediakan URL OCSP dari ekstensi akses informasi otoritas (AIA) atau properti sertifikat. Untuk parameter pvPara : Penunjuk ke struktur CERT_CONTEXT yang URL OCSP-nya diminta.
URL_OID_CERTIFICATE_OCSP_AND_CRL_DIST_POINT	Menyediakan daftar URL titik distribusi OCSP dan CRL dari akses informasi otoritas (AIA) dan ekstensi titik distribusi CRL atau properti sertifikat. Fungsi mengembalikan URL OCSP terlebih dahulu. Sebelum menggunakan URL OCSP apa pun, Anda harus menghapus awalan L"ocsp:". Untuk parameter pvPara : Pointer ke struktur CERT_CONTEXT yang URL titik distribusi OCSP dan CRL-nya diminta.
URL_OID_CERTIFICATE_ONLY_OCSP	Menyediakan daftar URL OCSP dari ekstensi akses informasi otoritas (AIA) atau properti sertifikat. Sebelum menggunakan URL OCSP apa pun, Anda harus menghapus awalan L"ocsp:". Untuk parameter pvPara : Pointer ke struktur CERT_CONTEXT yang URL OCSP-nya diminta.
URL_OID_CTL_ISSUER	Menyediakan URL penerbit CTL yang diambil dari metode atribut akses informasi otoritas yang dikodekan dalam setiap informasi penanda tangan di PKCS #7 CTL. Untuk parameter pvPara : Penunjuk ke Indeks Penanda tangan CTL_CONTEXT struktur yang dikeluarkan oleh penerbit yang URL-nya, yang diidentifikasi oleh indeks penanda tangan, diminta.
URL_OID_CTL_NEXT_UPDATE	Menyediakan URL pembaruan berikutnya dari CTL yang diambil dari informasi otoritas mengakses ekstensi CTL, properti, atau metode atribut informasi penanda tangan. Untuk parameter pvPara : Penunjuk ke struktur CTL_CONTEXT Indeks Penanda Tangan yang URL pembaruan berikutnya diminta, dan indeks penanda tangan opsional, jika diperlukan untuk memeriksa atribut informasi penanda tangan.
URL_OID_CRL_ISSUER	Menyediakan URL penerbit CRL yang diambil dari properti pada CRL yang diwarisi dari sertifikat subjek (baik dari penerbit sertifikat subjek atau ekstensi titik distribusi sertifikat subjek). Ini dikodekan sebagai metode ekstensi akses informasi otoritas. Untuk parameter pvPara : Pointer ke struktur CRL_CONTEXT yang dikeluarkan oleh penerbit yang URL-nya diminta.
URL_OID_CERTIFICATE_FRESHEST_CRL	Mengambil ekstensi CRL terbaru atau properti sertifikat. Untuk parameter pvPara : PCCERT_CONTEXT sertifikat yang titik distribusi CRL terbarunya diminta.
URL_OID_CRL_FRESHEST_CRL	Mengambil ekstensi CRL terbaru atau properti CRL. Untuk parameter pvPara : Pointer ke struktur CERT_CRL_CONTEXT_PAIR yang berisi CRL dasar sertifikat yang titik distribusi CRL terbarunya diminta.
URL_OID_CROSS_CERT_DIST_POINT	Mengambil ekstensi titik distribusi sertifikat silang atau properti sertifikat. Untuk parameter pvPara : PCCERT_CONTEXT sertifikat yang titik distribusi sertifikat silangnya diminta.
URL_OID_CROSS_CERT_SUBJECT_INFO_ACCESS	Mengambil ekstensi Akses Informasi Subjek lintas sertifikat atau properti sertifikat. Untuk parameter pvPara : PCCERT_CONTEXT sertifikat yang akses informasi subjek lintas sertifikatnya sedang diminta.

[in] pvPara

Struktur yang ditentukan oleh nilai pszUrlOid. Untuk detailnya, lihat deskripsi untuk parameter pszUrlOid .

[in] dwFlags

Sekumpulan bendera yang digunakan untuk mendapatkan pencari URL untuk objek. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.

Nilai	Makna
CRYPT_GET_URL_FROM_PROPERTY	Menemukan URL dari properti objek (lokasi data).
CRYPT_GET_URL_FROM_EXTENSION	Menemukan URL dari ekstensi objek.
CRYPT_GET_URL_FROM_UNAUTH_ATTRIBUTE	Menemukan URL dari atribut yang tidak terauthentikasi dari data informasi penanda tangan.
CRYPT_GET_URL_FROM_AUTH_ATTRIBUTE	Menemukan URL dari atribut terautentikasi dari data informasi penanda tangan.

[out] pUrlArray

Penunjuk ke buffer untuk menerima data untuk entri nilai. Parameter ini dapat berupa NULL untuk menemukan panjang buffer yang diperlukan untuk menyimpan data.

Untuk informasi selengkapnya, lihat Mengambil Data Dengan Panjang Tidak Diketahui.

[in, out] pcbUrlArray

Penunjuk ke DWORD yang menentukan ukuran, dalam byte, dari buffer yang diarahkan oleh parameter pUrlArray . Saat fungsi kembali, DWORD berisi jumlah byte yang disimpan dalam buffer. Parameter ini dapat berupa NULL hanya jika pUrlArray adalah NULL.

[out] pUrlInfo

Penunjuk opsional ke struktur CRYPT_URL_INFO yang menerima data untuk entri nilai.

[in, out] pcbUrlInfo

Penunjuk ke DWORD yang menentukan ukuran, dalam byte, dari buffer yang diarahkan oleh parameter pUrlArray . Saat fungsi kembali, DWORD berisi jumlah byte yang disimpan dalam buffer.

Catatan Saat memproses data yang dikembalikan dalam buffer, aplikasi harus menggunakan ukuran aktual data yang dikembalikan. Ukuran aktual bisa sedikit lebih kecil dari ukuran buffer yang ditentukan pada input. Pada input, ukuran buffer biasanya ditentukan cukup besar untuk memastikan bahwa data output terbesar yang mungkin akan pas di buffer. Pada output, variabel yang diacu oleh parameter ini diperbarui untuk mencerminkan ukuran aktual data yang disalin ke buffer.

pvReserved

Dicadangkan untuk digunakan di masa mendatang dan harus NULL.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol (TRUE).

Jika fungsi gagal, fungsi mengembalikan nol (FALSE). Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Cryptnet.lib
DLL	Cryptnet.dll

Lihat juga

Fungsi Pengambilan Objek Jarak Jauh

Bagikan melalui