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	一或多個參數無效。
ERROR_NOT_SUPPORTED	從 Windows 8 和 Windows Server 2012 開始，您必須呼叫 CryptCATOpen 函式，並將 dwPublicVersion 參數設定為 0x100 或 0x200，以擷取控制碼。如需詳細資訊，請參閱＜備註＞。

呼叫CryptCATPersistStore之前，必須先初始化CRYPTCATSTORE結構。

從 Windows 8 和 Windows Server 2012 開始，下列變更適用于此函式：

如果使用0x200 的 dwPublicVersion參數呼叫CryptCATOpen，則會使用 v2 格式來撰寫目錄。
如果使用0x100 的 dwPublicVersion參數呼叫CryptCATOpen，則會使用 v1 格式來撰寫目錄。
如果使用 0x200 或 0x100 以外的dwPublicVersion參數呼叫CryptCATOpen，CryptCATPersistStore函式會傳回FALSE，並將錯誤碼設定為ERROR_NOT_SUPPORTED。