CryptCATCDFEnumMembersByCDFTagEx 函式

[ CryptCATCDFEnumMembersByCDFTagEx 函式可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]

CryptCATCDFEnumMembersByCDFTagEx函式會列舉目錄定義檔之 CatalogFiles區段中的個別檔案成員， (CDF) 。 CryptCATCDFEnumMembersByCDFTagEx 是由 MakeCat呼叫。

注意

此函式沒有相關聯的標頭檔或匯入程式庫。 若要呼叫此函式，您必須建立使用者定義的標頭檔，並使用 LoadLibrary 和 GetProcAddress 函式動態連結至Mssign32.dll。

 

語法

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
);

參數

pCDF [in]

CRYPTCATCDF結構的指標。

pwszPrevCDFTag [in， out]

識別類別目錄檔案成員之 Null終止字串的指標。

pfnParseError [in]

用來處理檔案剖析錯誤的使用者定義函式指標。

ppMember [in]

CRYPTCATMEMBER結構的指標，其中包含檔案成員資訊。

fContinueOnError [in]

值，指定是否要在記憶體中保留最後一個列舉成員的參考。

pvReserved [in]

這個參數是保留的;請勿使用它。

傳回值

成功時，此函式會傳回 以 Null終止字串的指標，以識別 CDF 之 CatalogFiles 區段中的檔案成員。 CryptCATCDFEnumMembersByCDFTagEx函式會在失敗時傳回Null指標。

備註

您通常會在迴圈中呼叫此函式，以列舉 CDF 中的所有目錄檔案成員。 進入迴圈之前，請將 pwszPrevCDFTag 設定為 Null。 函式會傳回第一個成員的指標。 將 pwszPrevCDFTag 設定為函式的傳回值，以供迴圈的後續反復專案使用。

範例

下列範例顯示 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);

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
DLL	Wintrust.dll

另請參閱

MakeCat

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary