ホーム › Security.Cryptography › CertGetSubjectCertificateFromStore

CertGetSubjectCertificateFromStore

関数

ストアからサブジェクトに一致する証明書を取得する。

DLLCRYPT32.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

// CRYPT32.dll
#include <windows.h>

CERT_CONTEXT* CertGetSubjectCertificateFromStore(
    HCERTSTORE hCertStore,
    CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
    CERT_INFO* pCertId
);

パラメーター

名前	型	方向	説明
hCertStore	HCERTSTORE	in	証明書ストアのハンドルです。
dwCertEncodingType	CERT_QUERY_ENCODING_TYPE	in	使用するエンコードの種類です。次の例のように、証明書のエンコードの種類とメッセージのエンコードの種類の両方をビットごとの OR 演算で組み合わせて指定することは、常に許容されます。 X509_ASN_ENCODING \| PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。 X509_ASN_ENCODING PKCS_7_ASN_ENCODING
pCertId	CERT_INFO*	in	CERT_INFO 構造体へのポインターです。Issuer メンバーと SerialNumber メンバーのみが使用されます。

名前

型

方向

説明

hCertStore

HCERTSTORE

証明書ストアのハンドルです。

dwCertEncodingType

CERT_QUERY_ENCODING_TYPE

使用するエンコードの種類です。次の例のように、証明書のエンコードの種類とメッセージのエンコードの種類の両方をビットごとの OR 演算で組み合わせて指定することは、常に許容されます。

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

pCertId

CERT_INFO*

CERT_INFO 構造体へのポインターです。Issuer メンバーと SerialNumber メンバーのみが使用されます。

戻り値の型: CERT_CONTEXT*

公式ドキュメント

証明書ストアから、発行者とシリアル番号によって一意に識別されるサブジェクト証明書コンテキストを返します。

戻り値

関数が成功すると、読み取り専用の CERT_CONTEXT へのポインターが返されます。この CERT_CONTEXT は CertFreeCertificateContext を呼び出して解放する必要があります。

返された証明書は有効でない場合があります。通常、その発行者証明書を取得する際(CertGetIssuerCertificateFromStore)に検証されます。

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

戻り値	説明
CRYPT_E_NOT_FOUND	サブジェクト証明書がストア内に見つかりませんでした。

解説(Remarks)

CertDuplicateCertificateContext を呼び出すと、証明書の複製を作成できます。

例

次の例は、発行者とシリアル番号によって一意に識別されるサブジェクトの証明書コンテキストを、証明書ストアから取得する方法を示しています。この例の完全なコンテキストを含む例については、 C プログラムの例: メッセージの署名、エンコード、デコード、および検証を参照してください。


#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>

#define MY_ENCODING_TYPE  (PKCS_7_ASN_ENCODING | X509_ASN_ENCODING)

void main()
{
//-------------------------------------------------------------------
// Declare and initialize variables.

HCERTSTORE hStoreHandle;           // certificate store handle
HCRYPTMSG hMsg;
PCCERT_CONTEXT pSignerCertContext;
DWORD          cbSignerCertInfo;
PCERT_INFO     pSignerCertInfo;
//-------------------------------------------------------------------
//  This code is based on hMsg being a signed, encoded message
//  read from a file or otherwise acquired. For detailed code, see 
//  "Example C Program: Signing, Encoding, Decoding, and Verifying a 
//  Message."

//-------------------------------------------------------------------
// Retrieve the signer CERT_INFO from the message by first getting
// the size of the memory required for the certificate.

if(CryptMsgGetParam(
   hMsg,                         // handle to the message
   CMSG_SIGNER_CERT_INFO_PARAM,  // parameter type
   0,                            // index
   NULL,   
   &cbSignerCertInfo))           // size of the returned information

{
   printf("%d bytes needed for the buffer.\n", cbSignerCertInfo);
}
else
{
   printf("Verify SIGNER_CERT_INFO #1 failed\n");
   exit(1);
}

//-------------------------------------------------------------------
// Allocate memory.

pSignerCertInfo = (PCERT_INFO) malloc(cbSignerCertInfo);
if (!pSignerCertInfo)
{
    printf("Verify memory allocation failed.\n");
    exit(1);
}

//-------------------------------------------------------------------
// Get the message certificate information (CERT_INFO
// structure).

if(!(CryptMsgGetParam(
     hMsg,                         // handle to the message
     CMSG_SIGNER_CERT_INFO_PARAM,  // parameter type
     0,                            // index
     pSignerCertInfo,              // address for returned information
     &cbSignerCertInfo)))          // size of the returned information

{
    printf("Verify SIGNER_CERT_INFO #2 failed.\n");
    exit(1);
}

//-------------------------------------------------------------------
// Open a certificate store in memory using CERT_STORE_PROV_MSG,
// which initializes it with the certificates from the message.

hStoreHandle = CertOpenStore(
   CERT_STORE_PROV_MSG,         // store provider type 
   MY_ENCODING_TYPE,            // encoding type
   NULL,                        // cryptographic provider
                                // use NULL for the default
   0,                           // flags
   hMsg));                      // handle to the message
   
if (hStoreHandle)
{
    printf("The certificate store to be used for message\n ");
    printf("    verification has been opened. \n");
}
else  
{
    printf("Verify open store failed.\n");
    exit(1);
}

//-------------------------------------------------------------------
// Find the signer's certificate in the store.

pSignerCertContext = CertGetSubjectCertificateFromStore(
    hStoreHandle,       // handle to store
    MY_ENCODING_TYPE,   // encoding type
    pSignerCertInfo));  // pointer to retrieved CERT_CONTEXT
    
if(pSignerCertContext)
{

//-------------------------------------------------------------------
// Use the certificate retrieved from the message. For some 
// processing that can be done with the certificate, see the full
// program.

}
//-------------------------------------------------------------------
// Clean up.

if(pSignerCertInfo)
   free(pSignerCertInfo);
if(pSignerCertContext)
   CertFreeCertificateContext(pSignerCertContext); 
if(hStoreHandle)
   CertCloseStore(hStoreHandle, CERT_CLOSE_STORE_FORCE_FLAG);
if(hMsg)
   CryptMsgClose(hMsg);

}

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// CRYPT32.dll
#include <windows.h>

CERT_CONTEXT* CertGetSubjectCertificateFromStore(
    HCERTSTORE hCertStore,
    CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
    CERT_INFO* pCertId
);

[DllImport("CRYPT32.dll", SetLastError = true, ExactSpelling = true)]
static extern IntPtr CertGetSubjectCertificateFromStore(
    IntPtr hCertStore,   // HCERTSTORE
    uint dwCertEncodingType,   // CERT_QUERY_ENCODING_TYPE
    IntPtr pCertId   // CERT_INFO*
);

<DllImport("CRYPT32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CertGetSubjectCertificateFromStore(
    hCertStore As IntPtr,   ' HCERTSTORE
    dwCertEncodingType As UInteger,   ' CERT_QUERY_ENCODING_TYPE
    pCertId As IntPtr   ' CERT_INFO*
) As IntPtr
End Function

' hCertStore : HCERTSTORE
' dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
' pCertId : CERT_INFO*
Declare PtrSafe Function CertGetSubjectCertificateFromStore Lib "crypt32" ( _
    ByVal hCertStore As LongPtr, _
    ByVal dwCertEncodingType As Long, _
    ByVal pCertId As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

CertGetSubjectCertificateFromStore = ctypes.windll.crypt32.CertGetSubjectCertificateFromStore
CertGetSubjectCertificateFromStore.restype = ctypes.c_void_p
CertGetSubjectCertificateFromStore.argtypes = [
    wintypes.HANDLE,  # hCertStore : HCERTSTORE
    wintypes.DWORD,  # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
    ctypes.c_void_p,  # pCertId : CERT_INFO*
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPT32.dll')
CertGetSubjectCertificateFromStore = Fiddle::Function.new(
  lib['CertGetSubjectCertificateFromStore'],
  [
    Fiddle::TYPE_VOIDP,  # hCertStore : HCERTSTORE
    -Fiddle::TYPE_INT,  # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
    Fiddle::TYPE_VOIDP,  # pCertId : CERT_INFO*
  ],
  Fiddle::TYPE_VOIDP)

#[link(name = "crypt32")]
extern "system" {
    fn CertGetSubjectCertificateFromStore(
        hCertStore: *mut core::ffi::c_void,  // HCERTSTORE
        dwCertEncodingType: u32,  // CERT_QUERY_ENCODING_TYPE
        pCertId: *mut CERT_INFO  // CERT_INFO*
    ) -> *mut CERT_CONTEXT;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("CRYPT32.dll", SetLastError = true)]
public static extern IntPtr CertGetSubjectCertificateFromStore(IntPtr hCertStore, uint dwCertEncodingType, IntPtr pCertId);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertGetSubjectCertificateFromStore' -Namespace Win32 -PassThru
# $api::CertGetSubjectCertificateFromStore(hCertStore, dwCertEncodingType, pCertId)

#uselib "CRYPT32.dll"
#func global CertGetSubjectCertificateFromStore "CertGetSubjectCertificateFromStore" sptr, sptr, sptr
; CertGetSubjectCertificateFromStore hCertStore, dwCertEncodingType, varptr(pCertId)   ; 戻り値は stat
; hCertStore : HCERTSTORE -> "sptr"
; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "sptr"
; pCertId : CERT_INFO* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "CRYPT32.dll"
#cfunc global CertGetSubjectCertificateFromStore "CertGetSubjectCertificateFromStore" sptr, int, var
; res = CertGetSubjectCertificateFromStore(hCertStore, dwCertEncodingType, pCertId)
; hCertStore : HCERTSTORE -> "sptr"
; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int"
; pCertId : CERT_INFO* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPT32.dll"
#cfunc global CertGetSubjectCertificateFromStore "CertGetSubjectCertificateFromStore" sptr, int, sptr
; res = CertGetSubjectCertificateFromStore(hCertStore, dwCertEncodingType, varptr(pCertId))
; hCertStore : HCERTSTORE -> "sptr"
; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int"
; pCertId : CERT_INFO* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。