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 函式來安裝或註冊其他存放區提供者。 如需新增存放區提供者的詳細資訊，請參閱 擴充 CertOpenStore 功能。

[in] dwEncodingType

指定 憑證編碼類型， 和 訊息編碼類型。 只有當 CertSaveStore 函式的 dwSaveAs 參數包含 CERT_STORE_SAVE_AS_PKCS7時，才會使用編碼。 否則，不會使用 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

這些值是由使用位OR 運算結合的高字和低字值所組成。

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開啟系統存放區，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
• \\ComputerName\CA
• ComputerName\ServiceName\Trust
• \\ComputerName\ServiceName\信任

如需系統存放區的詳細資訊，請參閱 系統存放區位置。

如需自動移轉之存放區的詳細資訊，請參閱 證書儲存移轉。

例子

下列範例示範開啟不同存放區提供者類型的數個證書存儲。 此範例使用 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

證書存儲函式