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] |
|
関連項目