Fungsi CryptSIPRetrieveSubjectGuidForCatalogFile (mssip.h)

  • Artikel

Fungsi CryptSIPRetrieveSubjectGuidForCatalogFile mengambil GUID subjek yang terkait dengan file yang ditentukan.

Sintaks

BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
  [in]           LPCWSTR FileName,
  [in, optional] HANDLE  hFileIn,
  [out]          GUID    *pgSubject
);

Parameter

[in] FileName

Nama file. Jika parameter hFileIn diatur, nilai dalam parameter ini diabaikan.

[in, optional] hFileIn

Handel ke file untuk diperiksa. Parameter ini harus berisi handel yang valid jika parameter FileName adalah NULL.

[out] pgSubject

ID unik global yang mengidentifikasi subjek.

Mengembalikan nilai

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil; jika tidak, FALSE.

Jika fungsi ini mengembalikan FALSE, informasi kesalahan tambahan dapat diperoleh dengan memanggil fungsi GetLastError . GetLastError akan mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
 Satu atau beberapa parameter tidak valid.

Keterangan

Fungsi ini hanya mendukung paket antarmuka subjek (SIP) yang digunakan untuk gambar portabel yang dapat dieksekusi (.exe), gambar kabinet (.cab), dan file datar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header mssip.h
Pustaka Crypt32.lib
DLL Crypt32.dll