次の方法で共有

CryptCATCDFEnumMembersByCDFTagEx 関数

  • [アーティクル]

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

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

Note

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

このパラメーターは予約されています。使用しないでください。

戻り値

成功すると、この関数は、CDF の CatalogFiles セクションでファイル メンバーを識別する null で終わる文字列へのポインターを返します。 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