CryptCATCDFEnumAttributesWithCDFTag 函式

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

CryptCATCDFEnumAttributesWithCDFTag函式會在目錄定義檔的 CatalogFiles區段中列舉成員檔案的屬性， (CDF) 。 CryptCATCDFEnumAttributesWithCDFTag 是由 MakeCat呼叫。

注意

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

 

語法

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

參數

pCDF [in]

CRYPTCATCDF結構的指標。

pwszMemberTag [in]

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

pMember [in]

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

pPrevAttr [in]

PCDF指向之 CDF 中檔案成員屬性之CRYPTCATATTRIBUTE結構的指標。

pfnParseError [in]

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

傳回值

成功時，此函式會傳回 CRYPTCATATTRIBUTE 結構的指標。 CryptCATCDFEnumAttributesWithCDFTag函式會在失敗時傳回Null指標。

備註

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

範例

下列範例顯示 pPrevAttr 參數 () pAttr 的正確指派順序。

    CRYPTCATATTRIBUTE   *pAttr;
    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

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

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        pAttr = NULL;

        while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
                                                           pwszMemberTag,
                                                           pMember,
                                                           pAttr,
                                                           DisplayParseError))
        {
            //do something with pAttr
        }

    }

    CryptCATCDFClose(pCDF);

規格需求

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

另請參閱

MakeCat

CRYPTCATATTRIBUTE

CRYPTCATCDF

CRYPTCATMEMBER

GetProcAddress

LoadLibrary