CertSerializeCTLStoreElement 関数 (wincrypt.h)

  • [アーティクル]

CertSerializeCTLStoreElement 関数は、エンコードされた証明書信頼リスト (CTL) コンテキストとそのプロパティのエンコードされた表現をシリアル化します。 CTL とプロパティを後で取得できるように、結果をストレージに永続化できます。

構文

BOOL CertSerializeCTLStoreElement(
  [in]      PCCTL_CONTEXT pCtlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

パラメーター

[in] pCtlContext

シリアル化される CTL_CONTEXT 構造体へのポインター。

[in] dwFlags

将来使用するために予約されており、0 である必要があります。

[out] pbElement

エンコードされた CTL とそのプロパティを含む、シリアル化された出力を受け取るバッファーへのポインター。

このパラメーターは、メモリ割り当てのためにこの情報のサイズを設定するために NULL にすることができます 。 詳細については、「 不明な長さのデータの取得」を参照してください。

[in, out] pcbElement

pbElement パラメーターによって指されるバッファーのサイズをバイト単位で指定する DWORD 値へのポインター。 関数が DWORD 値を返す場合、バッファーに格納されているバイト数が含まれます。

メモ バッファーで返されるデータを処理する場合、アプリケーションは返されるデータの実際のサイズを使用する必要があります。 実際のサイズは、入力時に指定されたバッファーのサイズよりも少し小さくすることができます。 (入力では、バッファー サイズは通常、可能な最大の出力データがバッファーに収まるように十分な大きさで指定されます)。出力時に、このパラメーターが指す変数が更新され、バッファーにコピーされたデータの実際のサイズが反映されます。
 

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報については、 GetLastError を呼び出します。

要件

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

こちらもご覧ください

CertAddSerializedElementToStore

証明書信頼リスト関数