CryptCATPutCatAttrInfo 関数 (mscat.h)

  • [アーティクル]

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

CryptCATPutCatAttrInfo 関数は、カタログ ファイル属性にメモリを割り当ててカタログに追加します。

構文

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

パラメーター

[in] hCatalog

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

[in] pwszReferenceTag

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

[in] dwAttrTypeAndAction

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

値 説明
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