Fungsi CryptCATCDFEnumMembersByCDFTagEx

[Fungsi CryptCATCDFEnumMembersByCDFTagEx tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CryptCATCDFEnumMembersByCDFTagEx menghitung anggota file individual di bagian CatalogFiles dari file definisi katalog (CDF). CryptCATCDFEnumMembersByCDFTagEx dipanggil oleh MakeCat.

Catatan

Fungsi ini tidak memiliki file header atau pustaka impor terkait. Untuk memanggil fungsi ini, Anda harus membuat file header yang ditentukan pengguna dan menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Mssign32.dll.

 

Sintaks

LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
  _In_    CRYPTCATCDF                  *pCDF,
  _Inout_ LPWSTR                       pwszPrevCDFTag,
  _In_    PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
  _In_    CRYPTCATMEMBER               **ppMember,
  _In_    BOOL                         fContinueOnError,
  _In_    LPVOID                       pvReserved
);

Parameter

pCDF [in]

Penunjuk ke struktur CRYPTCATCDF .

pwszPrevCDFTag [masuk, keluar]

Penunjuk ke string yang dihentikan null yang mengidentifikasi anggota file katalog.

pfnParseError [in]

Penunjuk ke fungsi yang ditentukan pengguna untuk menangani kesalahan penguraian file.

ppMember [in]

Penunjuk ke struktur CRYPTCATMEMBER yang berisi informasi anggota file.

fContinueOnError [in]

Nilai yang menentukan apakah akan menyimpan dalam memori referensi ke anggota terakhir yang dijumlahkan.

pvReserved [in]

Parameter ini dicadangkan; jangan gunakan.

Menampilkan nilai

Setelah berhasil, fungsi ini mengembalikan penunjuk ke string yang dihentikan null yang mengidentifikasi anggota file di bagian CatalogFiles dari CDF. Fungsi CryptCATCDFEnumMembersByCDFTagEx mengembalikan penunjuk NULL jika gagal.

Keterangan

Anda biasanya memanggil fungsi ini dalam perulangan untuk menghitung semua anggota file katalog dalam CDF. Sebelum memasukkan perulangan, atur pwszPrevCDFTag ke NULL. Fungsi mengembalikan penunjuk ke anggota pertama. Atur pwszPrevCDFTag ke nilai pengembalian fungsi untuk perulangan perulangan berikutnya.

Contoh

Contoh berikut menunjukkan urutan penugasan yang benar untuk parameter pwszPrevCDFTag (pwszMemberTag).

    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L'myCDF', NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        //do something with pwszMemberTag and pMember
    }

    CryptCATCDFClose(pCDF);

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
DLL	Wintrust.dll

Lihat juga

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary