CryptCATPersistStore 関数 (mscat.h)

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

CryptCATPersistStore 関数は、指定されたカタログストア内の情報を署名されていないカタログファイルに保存します。

構文

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

[in] hCatalog

CryptCATHandleFromStore または CryptCATOpen 関数から取得したカタログへのハンドル。 Windows 8 以降では、 CryptCATOpen のみを使用してハンドルを取得する必要があります。

関数が成功した場合、戻り値は TRUE です。それ以外の場合は FALSE。

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

リターンコード	説明
ERROR_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
ERROR_NOT_SUPPORTED	Windows 8 および Windows Server 2012 以降では、dwPublicVersion パラメーターを 0x100 または 0x200 に設定して CryptCATOpen 関数を呼び出してハンドルを取得する必要があります。詳細については、「解説」を参照してください。

CryptCATPersistStore を呼び出す前に、CRYPTCATSTORE 構造体を初期化する必要があります。

Windows 8 および Windows Server 2012 以降では、この関数に次の変更が適用されます。

0x200 の dwPublicVersion パラメーターを使用して CryptCATOpen が呼び出された場合、カタログは v2 形式を使用して書き込まれます。
0x100の dwPublicVersion パラメーターを使用して CryptCATOpen が呼び出された場合、カタログは v1 形式を使用して書き込まれます。
0x200または0x100以外の dwPublicVersion パラメーターを使用して CryptCATOpen が呼び出された場合、CryptCATPersistStore 関数は FALSE を返し、エラーコードは ERROR_NOT_SUPPORTED に設定されます。