CertFindCertificateInStore 関数 (wincrypt.h)

CertFindCertificateInStore 関数は、dwFindType とそれに関連付けられた pvFindParaによって確立された検索条件に一致する、証明書ストア 内の最初または次の証明書 コンテキスト を検索します。 この関数をループで使用すると、指定した検索条件に一致する 証明書ストア 内のすべての 証明書 を検索できます。

構文

PCCERT_CONTEXT CertFindCertificateInStore(
  [in] HCERTSTORE     hCertStore,
  [in] DWORD          dwCertEncodingType,
  [in] DWORD          dwFindFlags,
  [in] DWORD          dwFindType,
  [in] const void     *pvFindPara,
  [in] PCCERT_CONTEXT pPrevCertContext
);

パラメーター

[in] hCertStore

検索する 証明書ストアのハンドル。

[in] dwCertEncodingType

使用するエンコードの種類を指定します。 次の例に示すように、証明書と の両方のメッセージ エンコードの種類 をビットごとのOR 操作と組み合わせて指定する必要があります。

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] dwFindFlags

一部の dwFindType 値と共に使用され、検索条件を変更します。 ほとんどの dwFindType 値では、dwFindFlags は使用されず、ゼロに設定する必要があります。 詳細については、「解説」を参照してください。

[in] dwFindType

検索する検索の種類を指定します。 検索の種類によって、データ型、コンテンツ、および pvFindPara使用が決まります。 このパラメーターには、次のいずれかの値を指定できます。

[in] pvFindPara

dwFindTypeで使用されるデータ項目または構造体を指します。

[in] pPrevCertContext

この関数によって返される最後の CERT_CONTEXT 構造体へのポインター。 このパラメーターは、関数の最初の呼び出しで NULL する必要があります。 検索条件を満たす連続する証明書を検索するには、pPrevCertContext 、前の関数呼び出しによって返されたポインターに設定します。 この関数は、このパラメーターの非NULL 値によって参照される CERT_CONTEXT を解放します。

戻り値

関数が成功した場合、関数は読み取り専用の CERT_CONTEXT 構造体へのポインターを返します。

関数が失敗し、検索条件に一致する証明書が見つからない場合、戻り値は NULL。

CertFindCertificateInStore 返す以外の NULLCERT_CONTEXT は、CertFreeCertificateContext によって解放されるか、CertFindCertificateInStoreへの後続の呼び出 しで pPrevCertContext パラメーターとして渡される必要があります。

拡張エラー情報については、GetLastError呼び出します。 考えられるエラー コードの一部を次に示します。

備考

dwFindFlags パラメーターは、一部の検索の種類の条件を変更するために使用されます。

CERT_UNICODE_IS_RDN_ATTRS_FLAG dwFindFlags 値は、dwFindTypeのCERT_FIND_SUBJECT_ATTR値とCERT_FIND_ISSUER_ATTR値 使用されます。 pvFindPara が指す CERT_RDN_ATTR 構造体 Unicode 文字列で初期化された場合は、CERT_UNICODE_IS_RDN_ATTRS_FLAGを設定する必要があります。 比較を行う前に、一致する文字列を X509_UNICODE_NAME を使用して変換し、Unicode 比較を提供します。

次の dwFindFlags 値は、dwFindTypeのCERT_FIND_ENKEY_USAGE値 使用されます。

CertDuplicateCertificateContext を呼び出して、返されたコンテキストの複製を作成できます。 返されたコンテキストは、CertAddCertificateContextToStoreを使用して別の 証明書ストア に追加することも、CertAddCertificateLinkToStoreを使用してコレクション ストアではないストアにリンク 追加することもできます。

返されたポインターは、関数への後続の呼び出しで pPrevCertContext パラメーターとして渡されると解放されます。 それ以外の場合は、CertFreeCertificateContext呼び出すことによって、ポインターを明示的に解放する必要があります。 null ではない pPrevCertContext は、CertFindCertificateInStore によって、関数にエラーが発生した場合でも、CertFreeCertificateContextへの呼び出しを使用して常に解放されます。

例

次の例は、検索条件を満たす証明書ストアで証明書コンテキストを見つける方法を示しています。 この例のコンテキストを含む完全な例については、「例 C Program: Certificate Store Operations」を参照してください。

この関数を使用する別の例については、「例 C Program: Collection and Sibling Certificate Store Operations」を参照してください。

#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>
#pragma comment(lib, "crypt32.lib")

#define MY_ENCODING_TYPE  (PKCS_7_ASN_ENCODING | X509_ASN_ENCODING)

void main()
{
//-------------------------------------------------------------------
// Declare and initialize variables.
HCERTSTORE  hSystemStore;              // The system store handle.
PCCERT_CONTEXT  pDesiredCert = NULL;   // Set to NULL for the first 
                                       // call to
                                       // CertFindCertificateInStore.
LPCSTR lpszCertSubject = (LPCSTR) "Cert_subject_1";


//-------------------------------------------------------------------
// Open the certificate store to be searched.

if(hSystemStore = CertOpenStore(
     CERT_STORE_PROV_SYSTEM, 
     0,                      // Encoding type not needed 
                             // with this PROV.
     NULL,                   // Accept the default HCRYPTPROV. 
     CERT_SYSTEM_STORE_CURRENT_USER,
                             // Set the system store location in 
                             // the registry.
     L"MY"))                 // Could have used other predefined 
                             // system stores
                             // including Trust, CA, or Root.
{
   printf("Opened the MY system store. \n");
}
else
{
   printf( "Could not open the MY system store.\n");
   exit(1);
}
//-------------------------------------------------------------------
// Get a certificate that has lpszCertSubject as its 
// subject. 

if(pDesiredCert=CertFindCertificateInStore(
      hSystemStore,
      MY_ENCODING_TYPE,           // Use X509_ASN_ENCODING.
      0,                          // No dwFlags needed. 
      CERT_FIND_SUBJECT_STR,      // Find a certificate with a
                                  // subject that matches the string
                                  // in the next parameter.
      lpszCertSubject ,           // The Unicode string to be found
                                  // in a certificate's subject.
      NULL))                      // NULL for the first call to the
                                  // function. In all subsequent
                                  // calls, it is the last pointer
                                  // returned by the function.
{
  printf("The desired certificate was found. \n");
}
else
{
   printf("Could not find the desired certificate.\n");
}
//-------------------------------------------------------------------
// Clean up. 

if(pDesiredCert)
    CertFreeCertificateContext(pDesiredCert);
if(hSystemStore)
    CertCloseStore(
        hSystemStore, 
        CERT_CLOSE_STORE_CHECK_FLAG);

必要条件

関連項目

CERT_CONTEXT

CertAddCertificateContextToStore

CertAddCertificateLinkToStore

CertDuplicateCertificateContext

CertEnumCertificatesInStore

CertFreeCertificateContext

CertGetCertificateChain

CertNameToStr

証明書関数の