CryptCATGetAttrInfo 関数 (mscat.h)

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

CryptCATGetAttrInfo 関数は、カタログのメンバーの属性に関する情報を取得します。

構文

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

[in] hCatalog

属性情報を取得するメンバーを含むカタログのハンドル。このハンドルは、 CryptCATOpen 関数を呼び出すことによって取得されます。このパラメーターは必須であり、 NULL にすることはできません。

[in] pCatMember

属性情報を取得するメンバーを表す CRYPTCATMEMBER 構造体へのポインター。これを取得するには、 CryptCATGetMemberInfo 関数を呼び出します。このパラメーターは必須であり、 NULL にすることはできません。

[in] pwszReferenceTag

情報を取得する属性の名前を含む null で終わる Unicode 文字列へのポインター。このパラメーターは必須であり、 NULL にすることはできません。

この関数は、属性情報を含む CRYPTCATATTRIBUTE 構造体へのポインターを返します。関数が失敗した場合は、NULL が返されます。

大事な 返されたポインターや、返されたポインターが指すメンバーを解放しないでください。

この関数が NULL を返す場合は、 GetLastError 関数を呼び出すことで追加のエラー情報を取得できます。 GetLastError は、次のいずれかのエラーコードを返します。

リターンコード	説明
CRYPT_E_NOT_FOUND	メンバーまたは属性が見つかりませんでした。
ERROR_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。