CryptCATPutAttrInfo 関数 (mscat.h)

  • [アーティクル]

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

CryptCATPutAttrInfo 関数は、属性のメモリを割り当て、カタログ メンバーに追加します。

構文

CRYPTCATATTRIBUTE * CryptCATPutAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag,
  [in] DWORD          dwAttrTypeAndAction,
  [in] DWORD          cbData,
  [in] BYTE           *pbData
);

パラメーター

[in] hCatalog

CryptCATOpen または CryptCATHandleFromStore 関数から取得したカタログへのハンドル。

[in] pCatMember

カタログ メンバーを含む CRYPTCATMEMBER 構造体へのポインター。

[in] pwszReferenceTag

属性の名前を含む null で終わる文字列へのポインター。

[in] dwAttrTypeAndAction

次のフラグのビットごとの組み合わせを表す 値。 呼び出し元は、少なくとも CRYPTCAT_ATTR_DATABASE64 または CRYPTCAT_ATTR_DATAASCIIを指定する必要があります。

値 意味
CRYPTCAT_ATTR_AUTHENTICATED
0x10000000
 属性が認証されます。
CRYPTCAT_ATTR_UNAUTHENTICATED
0x20000000
 属性が認証されていません。
CRYPTCAT_ATTR_NAMEASCII
0x00000001
 属性は ASCII 文字列です。
CRYPTCAT_ATTR_NAMEOBJID
0x00000002
 属性は暗号化 オブジェクト識別子 (OID) です。
CRYPTCAT_ATTR_DATAASCII
0x00010000
 属性には、デコードすべきでない単純な ASCII 文字が含まれています。
CRYPTCAT_ATTR_DATABASE64
0x00020000
 属性は base 64 形式です。
CRYPTCAT_ATTR_DATAREPLACE
0x00040000
 属性は、既存の属性の値を置き換えます。

[in] cbData

pbData バッファー内のバイト数を示す 値です。

[in] pbData

属性値を含むメモリ バッファーへのポインター。

戻り値

成功すると、この関数は、割り当てられた属性を含む CRYPTCATATTRIBUTE 構造体へのポインターを返します。 呼び出し元は、このポインターまたはそのメンバーを解放することはできません。

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

リターン コード 説明
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。
ERROR_NOT_ENOUGH_MEMORY
 操作中にオペレーティング システムのメモリが不足しました。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー mscat.h
Library Wintrust.lib
[DLL] Wintrust.dll