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 函数包含 CERT_STORE_SAVE_AS_PKCS7的 dwSaveAs 参数时，才使用编码。 否则，不使用 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打开系统存储（如“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
• \\ComputerName\CA
• ComputerName\ServiceName\Trust
• \\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

证书存储函数