CryptCATCDFEnumAttributesWithCDFTag 関数

  • [アーティクル]

[ CryptCATCDFEnumAttributesWithCDFTag 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 以降のバージョンでは変更または使用できない場合があります。]

CryptCATCDFEnumAttributesWithCDFTag 関数は、カタログ定義ファイル (CDF) の CatalogFiles セクションにあるメンバー ファイルの属性を列挙します。 CryptCATCDFEnumAttributesWithCDFTag は MakeCat によって呼び出されます。

Note

この関数には、ヘッダー ファイルまたはインポート ライブラリが関連付けされません。 この関数を呼び出すには、ユーザー定義ヘッダー ファイルを作成し、 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