CryptCATOpen 関数 (mscat.h)

  • [アーティクル]

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

CryptCATOpen 関数はカタログを開き、開いているカタログにコンテキスト ハンドルを返します。

メモ 一部の古いバージョンの Wintrust.lib には、この関数のエクスポート情報が含まれていません。 この場合、 LoadLibrary 関数と GetProcAddress 関数を使用して、Wintrust.dll に動的にリンクする必要があります。
 

構文

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

パラメーター

[in] pwszFileName

カタログ ファイル名の null で終わる文字列へのポインター。

[in] fdwOpenFlags

既存のカタログ ファイルを開く場合は 0、または次の値の 1 つ以上のビットごとの組み合わせを開きます。

値 説明
CRYPTCAT_OPEN_ALWAYS
 ファイルが存在する場合は開くか、必要に応じて新しいファイルを作成します。
CRYPTCAT_OPEN_CREATENEW
 新しいカタログ ファイルが作成されます。 以前に作成したファイルが存在する場合は、上書きされます。
CRYPTCAT_OPEN_EXISTING
 既存のカタログ ファイルが開かれます。
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
 既存のカタログ ファイルが開かれます。 SPC_INDIRECT_DATAでページ ハッシュを除外します。
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
 既存のカタログ ファイルが開かれます。 SPC_INDIRECT_DATAにページ ハッシュを含める。 上記のCRYPTCAT_OPEN_EXCLUDE_PAGE_HASHESも設定されている場合は優先されます。
CRYPTCAT_OPEN_VERIFYSIGHASH
 既存のカタログ ファイルが開かれます。 証明書ではなく署名を検証します。
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
 既存のカタログ ファイルが開かれます。 コンテンツなしで CryptMsgDecode を実行します。
CRYPTCAT_OPEN_SORTED
 既存のカタログ ファイルが開かれます。 CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG) を実行します。

[in] hProv

暗号化サービス プロバイダー (CSP) へのハンドル。

[in] dwPublicVersion

ファイルのバージョン。 次のいずれかの値を指定できます。

値 説明
CRYPTCAT_VERSION_1
0x100
 バージョン 1 のファイル形式。
CRYPTCAT_VERSION_2
0x200
 バージョン 2 のファイル形式。

Windows 8 と Windows Server 2012: この値のサポートが開始されます。

[in] dwEncodingType

ファイルに使用されるエンコードの種類。 この値が 0 の場合、エンコードの種類は PKCS_7_ASN_ENCODING | に設定されます。X509_ASN_ENCODING。

戻り値

成功すると、この関数は開いているカタログへのハンドルを返します。 ハンドルの使用が完了したら、 CryptCATClose 関数を呼び出してハンドルを閉じます。 CryptCATOpen 関数は、失敗した場合INVALID_HANDLE_VALUEを返します。

要件

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

関連項目

CryptCATClose