Share via

CertSelectionGetSerializedBlob 関数 (cryptuiapi.h)

  • [アーティクル]

CertSelectionGetSerializedBlob 関数は、シリアル化された証明書 BLOB をCERT_SELECTUI_INPUT構造体から取得するために使用されるヘルパー関数です。

構文

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

パラメーター

[in] pcsi

証明書ストアと証明書コンテキスト チェーン情報を含む CERT_SELECTUI_INPUT 構造体へのポインター。

[out] ppOutBuffer

シリアル化された証明書 BLOB を受け取るバッファーへのポインターのアドレス。

[out] pulOutBufferSize

ppOutBuffer パラメーターが指すバッファーで受信した BLOB のサイズをバイト単位で受け取る ULONG へのポインター。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 hStore パラメーターと prgpChain パラメーターの両方が NULL でない場合は、E_INVALIDARGを返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

注釈

返されたシリアル化された BLOB は、ユーザーが資格情報選択 UI を使用して証明書を選択できるように、pvInAuthBuffer パラメーターの CredUIPromptForWindowsCredentials 関数に渡されます。

この関数の ppOutBuffer パラメーターが指すバッファーで返される BLOB でシリアル化される証明書は、CERT_SELECTUI_INPUT構造体の hStore メンバーと prgpChain メンバーの値に依存します。

hStore prgpChain シリアル化された証明書
NULL NULL 以外 prgpChain メンバーが指す証明書はシリアル化されます。
NULL 以外 NULL hStore メンバーによって指定された証明書がシリアル化されます。
NULL NULL 空の BLOB が返されます。
NULL 以外 NULL 以外 呼び出しは失敗し、関数は E_INVALIDARGを返します。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー cryptuiapi.h
[DLL] Cryptui.dll