CertOpenStore 函式 （wincrypt.h）

CertOpenStore 函式透過指定的儲存提供者類型開啟憑證儲存。 雖然此功能可用於大多數用途的憑證儲存，但建議 使用 CertOpenSystemStore 來開啟最常見的憑證儲存庫。 CertOpenStore 是較複雜選項和特殊情況的必備條件。

語法

HCERTSTORE CertOpenStore(
  [in] LPCSTR            lpszStoreProvider,
  [in] DWORD             dwEncodingType,
  [in] HCRYPTPROV_LEGACY hCryptProv,
  [in] DWORD             dwFlags,
  [in] const void        *pvPara
);

參數

[in] lpszStoreProvider

包含存放區提供者類型的 Null 終止 ANSI 字串指標。

下列值代表預先定義的存放區類型。 儲存提供者類型決定 pvPara 參數的內容，以及 dwFlags 參數高字的使用與意義。 可透過使用 CryptInstallOIDFunctionAddress 或 CryptRegisterOIDFunction 函式安裝或註冊額外的儲存服務提供者。 欲了解更多關於新增儲存服務提供者的資訊，請參閱 擴展認證OpenStore功能。

[in] dwEncodingType

指定 憑證編碼類型 及 訊息編碼類型。 編碼僅在 CertSaveStore 函式的 dwSaveAs 參數包含 CERT_STORE_SAVE_AS_PKCS7 時使用。 否則， dwMsgAndCertEncodingType 參數則不被使用 dwMsgAndCertEncodingType 參數。

此參數僅適用於 lpszStoreProvider 參數中指定 CERT_STORE_PROV_MSG、CERT_STORE_PROV_PKCS7 或 CERT_STORE_PROV_FILENAME 提供者類型時。 對於所有其他提供者類型，這個參數是未使用的，而且應該設定為零。

此參數可以是下列一或多個值的組合。

[in] hCryptProv

此參數未被使用，應設為 NULL。

Windows Server 2003 與 Windows XP： 一個密碼學提供者的帳號。 對此參數傳遞 NULL 會產生適當的預設提供者。 建議使用預設提供者。 預設或指定的密碼學提供者用於所有驗證主體憑證或 CRL 簽名的儲存功能。此參數的資料型態為 HCRYPTPROV。

[in] dwFlags

這些值由高字與低字值組成，透過位元順序 或運算組合而成。

dwFlags 的低字部分控制了所開啟憑證儲存庫的多種一般特性。 此部分可與所有存放區提供者類型搭配使用。 dwFlags 的低字部分可以是以下其中一個值。

CERT_STORE_PROV_SYSTEM、CERT_STORE_PROV_SYSTEM_REGISTRY 和 CERT_STORE_PROV_PHYSICAL 提供者類型使用以下 dwFlags 的高字來指定系統儲存登錄位置：

CERT_SYSTEM_STORE_CURRENT_SERVICE

CERT_SYSTEM_STORE_CURRENT_USER

CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY

CERT_SYSTEM_STORE_LOCAL_MACHINE

CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE

CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY

CERT_SYSTEM_STORE_SERVICES

CERT_SYSTEM_STORE_USERS

預設情況下，系統儲存位置會相對於 HKEY_CURRENT_USER、 HKEY_LOCAL_MACHINE或 HKEY_USERS 預設登錄檔金鑰開啟。 欲了解更多資訊，請參閱系統商店地點。

下列高字旗標會覆寫此預設行為。

CERT_STORE_PROV_REGISTRY提供者使用以下高字標誌。

CERT_STORE_PROV_FILE 和 CERT_STORE_PROV_FILENAME 提供者類型使用以下高字標誌。

CERT_STORE_PROV_LDAP提供者類型使用以下高字標誌。

[in] pvPara

32 位值，可包含此函式的其他資訊。 此參數的內容取決於 lpszStoreProvider 及其他參數的值。

傳回值

如果函式成功，函式會回傳一個代號到 憑證儲存。 使用完儲存後，呼叫 CertCloseStore 函式釋放帳號。

如果函式失敗，則會傳回 NULL。 如需擴充錯誤資訊，請呼叫 GetLastError。

言論

系統存放區是由一或多個實體同層級存放區所組成的集合。 每個系統存放區都有預先定義的實體同層級存放區。 在CERT_SYSTEM_STORE_CURRENT_USER開啟像「My」這樣的系統儲存後，會呼叫 CertOpenStore 來開啟系統儲存集合中所有實體儲存。 這些實體儲存裝置透過 CertAddStoreToCollection 函式加入系統儲存集合。 這些實體存放區中的所有憑證、CRL 和 CCL 都可透過邏輯系統存放區集合取得。

您可以從遠端開啟下列系統存放區位置：

• CERT_SYSTEM_STORE_LOCAL_MACHINE
• CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
• CERT_SYSTEM_STORE_SERVICES
• CERT_SYSTEM_STORE_USERS

系統會以遠端方式開啟系統存放區位置，方法是在傳遞至 pvPara 的字串中，加上計算機名稱的存放區名稱前置詞。 遠端系統存放區名稱的範例包括：

• ComputerName\CA
• \\電腦名稱\CA
• ComputerName\ServiceName\Trust
• \\電腦名稱\服務名稱\信任

欲了解更多系統儲存資訊，請參閱 系統儲存地點。

欲了解更多自動遷移的商店資訊，請參閱 憑證商店遷移。

例子

下列範例示範開啟不同存放區提供者類型的數個證書存儲。 範例中使用了 CreateMyDACL 函式，該函式在 「建立 DACL 」主題中定義，以確保開啟檔案是用正確的 DACL 建立的。 欲了解更多開啟其他商店提供者類型的範例，請參閱「 開啟憑證商店的範例 C 程式碼」。

//-------------------------------------------------------------------
// Open a system store, in this case, the My store.

HCERTSTORE hSysStore = NULL;
if(hSysStore = CertOpenStore(
   CERT_STORE_PROV_SYSTEM,          // The store provider type
   0,                               // The encoding type is
                                    // not needed
   NULL,                            // Use the default HCRYPTPROV
   CERT_SYSTEM_STORE_CURRENT_USER,  // Set the store location in a
                                    // registry location
   L"MY"                            // The store name as a Unicode 
                                    // string
   ))
{
    printf("The system store was created successfully.\n");
}
else
{
    printf("An error occurred during creation "
        "of the system store!\n");
    exit(1);
}

// Other common system stores include "Root", "Trust", and "Ca".


//-------------------------------------------------------------------
// Open a memory store. 

HCERTSTORE hMemStore = NULL;
if(hMemStore = CertOpenStore(
   CERT_STORE_PROV_MEMORY,   // The memory provider type
   0,                        // The encoding type is not needed
   NULL,                     // Use the default HCRYPTPROV
   0,                        // Accept the default dwFlags
   NULL                      // pvPara is not used
   ))
{
    printf("The memory store was created successfully.\n");
}
else
{
    printf("An error occurred during creation "
        "of the memory store!\n");
    exit(1);
}

//-------------------------------------------------------------------
// Open a read-only store from disk.

HANDLE       hFile = NULL;
HCERTSTORE   hFileStore = NULL;
LPCSTR       pszFileName = "TestStor2.sto";
SECURITY_ATTRIBUTES  sa;        // For DACL

// Create a DACL to use when opening the file.
sa.nLength = sizeof(SECURITY_ATTRIBUTES);
sa.bInheritHandle = FALSE;  

// Call function to set the DACL. The DACL is set in the 
// SECURITY_ATTRIBUTES lpSecurityDescriptor member.
if (!CreateMyDACL(&sa))
{
     // Error encountered; generate message and exit.
     printf("Failed CreateMyDACL.\n");
        exit(1);
}

// Obtain the file handle of an existing file.
if (hFile = CreateFile(
     pszFileName,                  // The file name
     GENERIC_READ|GENERIC_WRITE,   // Access mode: Read from and
                                   // write to this file
     0,                            // Share mode
     &sa,                          // Uses the DACL created 
                                   // previously 
     OPEN_ALWAYS,                  // How to create
     FILE_ATTRIBUTE_NORMAL,        // File attributes
     NULL))                        // Template
{
    printf("The file was opened successfully.\n");
}
else
{
    printf("An error occurred during opening of the file!\n");
    exit(1);
}

//-------------------------------------------------------------------
//  This file can contain data before the store itself.
//  At this point, read and use data in the open file that precedes
//  the serialized certificate store data. 
//  To open the certificate store, the file pointer must
//  be placed at the beginning of the certificate store data.

//-------------------------------------------------------------------
//  Open the store.

if(hFileStore = CertOpenStore(
    CERT_STORE_PROV_FILE,     // Load certificates from a file
    0,                        // Encoding type not used
    NULL,                     // Use the default HCRYPTPROV
    CERT_STORE_READONLY_FLAG, // Read-only store
    hFile                     // The handle for the open file 
                              // that is the source of the 
                              // certificates
    ))
{
    printf("The file store was created successfully.\n");
}
else
{
    printf("An error occurred during creation of the file store!\n");
    exit(1);
}

//-------------------------------------------------------------------
// After processing, close the certificate stores and the file.

if(CertCloseStore(
        hSysStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The system store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the "
        "system store.\n");
}

if(CertCloseStore(
        hMemStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The memory store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the "
        "memory store.\n");
}

if(CertCloseStore(
        hFileStore, 
        CERT_CLOSE_STORE_CHECK_FLAG))
{
    printf("The file store was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the file store.\n");
}

if(CloseHandle(hFile))
{
    printf("The file was closed successfully.\n");
}
else
{
    printf("An error occurred during closing of the file.\n");
}

要求

另請參閱

CERT_SYSTEM_STORE_RELOCATE_PARA

CertCloseStore

CertSaveStore

憑證儲存功能