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 プロバイダーの種類が指定されている場合にのみ適用されます。 他のすべてのプロバイダーの種類では、このパラメーターは使用されず、0 に設定する必要があります。

このパラメーターには、次の 1 つ以上の値を組み合わせて使用できます。

[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呼び出します。

備考

システム ストアは、1 つ以上の物理兄弟ストアで構成されるコレクションです。 システム ストアごとに、定義済みの物理兄弟ストアがあります。 CERT_SYSTEM_STORE_CURRENT_USERで "My" などのシステム ストアを開くと、CertOpenStore が呼び出され、システム ストア コレクション内のすべての物理ストアが開きます。 これらの各物理ストアは、CertAddStoreToCollection 関数を使用してシステム ストア コレクションに追加されます。 これらの物理ストア内のすべての証明書、CRL、および CCTL は、論理システム ストア コレクションを通じて使用できます。

次のシステム ストアの場所をリモートで開くことができます。

• 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

システム ストアの詳細については、「システム ストアの場所の」を参照してください。

自動的に移行されるストアの詳細については、「証明書ストアの移行」を参照してください。

例

次の例は、ストア プロバイダーの種類が異なる複数の証明書ストアを開く方法を示しています。 この例では、「DACL の作成」トピックで定義されている CreateMyDACL 関数を使用して、開いているファイルが適切な 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

証明書ストア関数