Win32 API 日本語リファレンス
ホームSecurity.Cryptography › CertGetCertificateContextProperty

CertGetCertificateContextProperty

関数
証明書コンテキストの指定プロパティを取得する。
DLLCRYPT32.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

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

BOOL CertGetCertificateContextProperty(
    const CERT_CONTEXT* pCertContext,
    DWORD dwPropId,
    void* pvData,   // optional
    DWORD* pcbData
);

パラメーター

名前方向説明
pCertContextCERT_CONTEXT*in取得対象のプロパティを含む証明書CERT_CONTEXT 構造体へのポインター。
dwPropIdDWORDin

取得するプロパティ。現在定義されている識別子と、pvData に返されるデータ型を次の表に示します。

CERT_ACCESS_STATE_PROP_ID

pvData のデータ型: DWORD 値へのポインター。

証明書への書き込み操作が永続化されるかどうかを示す DWORD 値を返します。証明書がメモリストア内にある場合、または読み取り専用で開かれたレジストリベースのストア内にある場合、この DWORD 値は設定されません。

CERT_AIA_URL_RETRIEVED_PROP_ID

この識別子は予約されています。

CERT_ARCHIVED_KEY_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書コンテキスト用に以前に保存された、暗号化されたキーハッシュを返します。

CERT_ARCHIVED_PROP_ID

pvData のデータ型: NULLCertGetCertificateContextProperty 関数が true を返す場合、指定したプロパティ ID が CERT_CONTEXT に存在します。

証明書が列挙時にスキップされることを示します。このプロパティが設定された証明書は、特定のハッシュやシリアル番号を持つ証明書を検索する場合などの明示的な検索操作で見つかります。このプロパティに関連付けられたデータは pvData にはありません。

CERT_AUTHORITY_INFO_ACCESS_PROP_ID

この識別子は予約されています。

CERT_AUTO_ENROLL_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書が自動登録された証明書の種類を示す、null で終端する Unicode 文字列を返します。

CERT_AUTO_ENROLL_RETRY_PROP_ID

この識別子は予約されています。

CERT_BACKED_UP_PROP_ID

この識別子は予約されています。

CERT_CA_DISABLE_CRL_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明機関 (CA) が使用する証明書に対する証明書失効リスト (CRL) の取得を無効にします。CA 証明書がこのプロパティを含む場合、CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID プロパティも含める必要があります。

CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

CA 証明書によって発行された証明書に使用するオンライン証明書状態プロトコル (OCSP) URL のリストを含みます。配列の内容は、pszAccessMethodszOID_PKIX_OCSP に設定された X509_AUTHORITY_INFO_ACCESS 構造体の抽象構文記法 1 (ASN.1) エンコードされたバイト列です。

CERT_CROSS_CERT_DIST_POINTS_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

クロス証明書の場所。現在、この識別子は証明書にのみ適用され、CRL や証明書信頼リスト (CTL) には適用されません。

BYTE 配列には、lpszStuctType パラメーターに X509_CROSS_CERT_DIST_POINTS 値を指定して CryptDecodeObject 関数でデコードされる、ASN.1 エンコードされた CROSS_CERT_DIST_POINTS_INFO 構造体が含まれます。

CERT_CTL_USAGE_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

ASN.1 エンコードされた CTL_USAGE 構造体を含むバイト配列を返します。

CERT_DATE_STAMP_PROP_ID

pvData のデータ型: FILETIME 構造体へのポインター。

証明書がストアに追加された時刻。

CERT_DESCRIPTION_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書 UI で表示されるプロパティを返します。このプロパティにより、ユーザーは証明書の用途を説明できます。

CERT_EFS_PROP_ID

この識別子は予約されています。

CERT_ENHKEY_USAGE_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

ASN.1 エンコードされた CERT_ENHKEY_USAGE 構造体を含むバイト配列を返します。この構造体には、拡張キー使用法のオブジェクト識別子 (OID) の配列が含まれ、それぞれが証明書の有効な用途を指定します。

CERT_ENROLLMENT_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

RequestID、CADNSName、CAName、DisplayName を含む保留中の要求の登録情報。データ形式は次のように定義されます。

バイト 内容
先頭 4 バイト 保留中の要求 ID
次の 4 バイト 終端の null 文字を含む CADNSName のサイズ(文字数)、続いて終端の null 文字を含む CADNSName 文字列
次の 4 バイト 終端の null 文字を含む CAName のサイズ(文字数)、続いて終端の null 文字を含む CAName 文字列
次の 4 バイト 終端の null 文字を含む DisplayName のサイズ(文字数)、続いて終端の null 文字を含む DisplayName 文字列

CERT_EXTENDED_ERROR_INFO_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書コンテキストの拡張エラー情報を含む、null で終端する Unicode 文字列を返します。

CERT_FORTEZZA_DATA_PROP_ID

この識別子は予約されています。

CERT_FRIENDLY_NAME_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書の表示名を含む、null で終端する Unicode 文字列を返します。

CERT_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

SHA1 ハッシュを返します。ハッシュが存在しない場合は、CryptHashCertificate 関数を使用して計算されます。

CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_ID

pvData のデータ型: HCRYPTPROV_OR_NCRYPT_KEY_HANDLE データ型へのポインター。

HCRYPTPROV または NCRYPT_KEY_HANDLE のいずれかを返します。

CERT_HCRYPTPROV_TRANSFER_PROP_ID

証明書に関連付けられた Cryptography API (CAPI) キーハンドルを返します。ハンドルの解放は呼び出し元が行う必要があります。コンテキストが解放されてもハンドルは解放されません。このプロパティ値は返された後に削除されます。CNG キーを持つコンテキストに対してこのプロパティを呼び出した場合、CRYPT_E_NOT_FOUND が返されます。

CERT_IE30_RESERVED_PROP_ID

この識別子は予約されています。

CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

この証明書の署名に使用された秘密キーに関連付けられた公開キーの MD5 ハッシュ。

CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

この証明書の発行者名とシリアル番号の MD5 ハッシュ。

CERT_KEY_CONTEXT_PROP_ID

pvData のデータ型: CERT_KEY_CONTEXT 構造体へのポインター。

CERT_KEY_CONTEXT 構造体を返します。

CERT_KEY_IDENTIFIER_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

存在しない場合は szOID_SUBJECT_KEY_IDENTIFIER 拡張を検索します。それも失敗した場合は、証明書の SubjectPublicKeyInfo メンバーに対して SHA1 ハッシュを実行して識別子の値を生成します。

CERT_KEY_PROV_HANDLE_PROP_ID

pvData のデータ型: HCRYPTPROV 値へのポインター。

CERT_KEY_CONTEXT_PROP_ID から取得したプロバイダーハンドルを返します。

CERT_KEY_PROV_INFO_PROP_ID

pvData のデータ型: CRYPT_KEY_PROV_INFO 構造体へのポインター。

CRYPT_KEY_PROV_INFO 構造体へのポインターを返します。

CERT_KEY_SPEC_PROP_ID

pvData のデータ型: DWORD 値へのポインター。

CERT_KEY_CONTEXT_PROP_ID が存在する場合、そこから取得した秘密キーを指定する DWORD 値を返します。存在しない場合で CERT_KEY_PROV_INFO_PROP_ID が存在する場合は、それが dwKeySpec のソースになります。

CERT_MD5_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

MD5 ハッシュを返します。ハッシュが存在しない場合は、CryptHashCertificate 関数を使用して計算されます。

CERT_NCRYPT_KEY_HANDLE_PROP_ID

pvData のデータ型: NCRYPT_KEY_HANDLE データ型へのポインター。

該当する場合は CERT_NCRYPT_KEY_SPEC を返します。

CERT_NCRYPT_KEY_HANDLE_TRANSFER_PROP_ID

証明書に関連付けられた CNG キーハンドルを返します。ハンドルの解放は呼び出し元が行う必要があります。コンテキストが解放されてもハンドルは解放されません。このプロパティ値は返された後に削除されます。レガシー (CAPI) キーを持つコンテキストに対してこのプロパティを呼び出した場合、CRYPT_E_NOT_FOUND が返されます。

CERT_NEW_KEY_PROP_ID

この識別子は予約されています。

CERT_NEXT_UPDATE_LOCATION_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

ASN.1 エンコードされた CERT_ALT_NAME_INFO 構造体を返します。

CERT_NEXT_UPDATE_LOCATION_PROP_ID は現在、CTL でのみ使用されます。

CERT_NO_AUTO_EXPIRE_CHECK_PROP_ID

この識別子は予約されています。

CERT_OCSP_CACHE_PREFIX_PROP_ID

この識別子は予約されています。

CERT_OCSP_RESPONSE_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

この証明書のエンコードされた OCSP 応答を返します。

CERT_PUB_KEY_CNG_ALG_BIT_LENGTH_PROP_ID

pvData のデータ型: null で終端する Unicode 文字列へのポインター。

証明書の公開キーアルゴリズムとビット長を表す L"<PUBKEY><BITLENGTH>" 文字列を返します。次の <PUBKEY> アルゴリズムがサポートされています。

Windows 8 および Windows Server 2012: このプロパティのサポートはここから開始されます。

CERT_PUBKEY_ALG_PARA_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

アルゴリズムパラメーターの継承をサポートする公開キーの場合、ASN.1 エンコードされた PublicKey アルゴリズムパラメーターを返します。デジタル署名標準 (DSS) の場合は、CryptEncodeObject 関数を使用してエンコードされたパラメーターを返します。このプロパティは CMS_PKCS7 が定義されている場合にのみ使用されます。

CERT_PUBKEY_HASH_RESERVED_PROP_ID

この識別子は予約されています。

CERT_PVK_FILE_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書の公開キーに関連付けられた秘密キーを含むファイルのファイル名を含む、null で終端する Unicode ワイド文字列を返します。

CERT_RENEWAL_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

更新された証明書のハッシュを返します。

CERT_REQUEST_ORIGINATOR_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書コンテキスト要求の発信元の DNS コンピューター名を含む、null で終端する Unicode 文字列を返します。

CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

コンテキストのルート証明書のアプリケーションポリシーを含む、エンコードされた CERT_POLICIES_INFO 構造体へのポインターを返します。このプロパティは、lpszStructType パラメーターを X509_CERT_POLICIES に、dwCertEncodingType パラメーターを X509_ASN_ENCODING とビット単位の OR で結合した PKCS_7_ASN_ENCODING に設定して CryptDecodeObject 関数を使用することでデコードできます。

CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_ID

この識別子は予約されています。

CERT_SHA1_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

SHA1 ハッシュを返します。ハッシュが存在しない場合は、CryptHashCertificate 関数を使用して計算されます。

CERT_SHA1_SHA256_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは 52 バイトで、SHA1 ハッシュ用の 20 バイトと SHA256 ハッシュ用の 32 バイトです。

SHA1 ハッシュと SHA256 ハッシュを組み合わせたものを返します。ハッシュが存在しない場合は、CryptHashCertificate 関数を使用して計算されます。

CERT_SHA256_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

SHA256 ハッシュを返します。ハッシュが存在しない場合は、CryptHashCertificate 関数を使用して計算されます。

CERT_SIGN_HASH_CNG_ALG_PROP_ID

pvData のデータ型: null で終端する Unicode 文字列へのポインター。

証明書の署名を表す L"<SIGNATURE>/<HASH>" 文字列を返します。<SIGNATURE> 値は CNG 公開キーアルゴリズムを示します。次のアルゴリズムがサポートされています。

<HASH> 値は CNG ハッシュアルゴリズムを示します。次のアルゴリズムがサポートされています。

一般的な例を次に示します。

  • L"RSA/SHA1"
  • L"RSA/SHA256"
  • L"ECDSA/SHA256"

Windows 7 および Windows Server 2008 R2: このプロパティのサポートはここから開始されます。

CERT_SIGNATURE_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

署名ハッシュを返します。ハッシュが存在しない場合は、CryptHashToBeSigned 関数を使用して計算されます。ハッシュの長さは SHA の場合は 20 バイト、MD5 の場合は 16 バイトです。

CERT_SMART_CARD_DATA_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

エンコードされたスマートカードデータへのポインターを返します。CertGetCertificateContextProperty を呼び出す前に、この定数を使用して、pvFindPara パラメーターを CERT_SMART_CARD_DATA_PROP_ID に、dwFindType パラメーターを CERT_FIND_PROPERTY に設定した CertFindCertificateInStore 関数を使用してスマートカード証明書を取得できます。

CERT_SMART_CARD_ROOT_INFO_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

エンコードされた CRYPT_SMART_CARD_ROOT_INFO 構造体へのポインターを返します。

CERT_SOURCE_LOCATION_PROP_ID

この識別子は予約されています。

CERT_SOURCE_URL_PROP_ID

この識別子は予約されています。

CERT_SUBJECT_DISABLE_CRL_PROP_ID

この識別子は予約されています。

CERT_SUBJECT_INFO_ACCESS_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書コンテキストのサブジェクト情報アクセス拡張を、エンコードされた CERT_SUBJECT_INFO_ACCESS 構造体として返します。

CERT_SUBJECT_NAME_MD5_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

証明書コンテキストのエンコードされたサブジェクト名の MD5 ハッシュを返します。

CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID

この識別子は予約されています。

CERT_SUBJECT_PUB_KEY_BIT_LENGTH_PROP_ID

pvData のデータ型: DWORD 値へのポインター。

証明書内の公開キーの長さ(ビット単位)を返します。

Windows 8 および Windows Server 2012: このプロパティのサポートはここから開始されます。

CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_ID

pvData のデータ型: BYTE 値の配列へのポインター。この配列のサイズは pcbData パラメーターで指定されます。

この証明書の公開キーの MD5 ハッシュを返します。

すべてのユーザー定義プロパティ識別子について、pvDataBYTE 値の配列を指します。

各プロパティ識別子の詳細については、CertSetCertificateContextPropertydwPropId パラメーターのドキュメントを参照してください。

pvDatavoid*outoptional

dwPropId によって決定されるデータを受け取るバッファーへのポインター。返される構造体のメンバーが指す構造体も、ベース構造体に続いて返されます。そのため、pcbData に格納されるサイズは、ベース構造体のサイズを超えることがよくあります。

このパラメーターを NULL にすると、メモリ割り当てのために情報のサイズを設定できます。詳細については、「長さが不明なデータの取得」を参照してください。

pcbDataDWORD*inout

pvData パラメーターが指すバッファーのサイズ(バイト単位)を指定する DWORD 値へのポインター。関数が返るとき、この DWORD 値にはバッファーに格納されるバイト数が含まれます。

実行時に必要なバッファーサイズを取得するには、pvData パラメーターに NULL を渡し、このパラメーターが指す値をゼロに設定します。pvData パラメーターが NULL ではなく、pcbData で指定されたサイズがデータを格納するために必要なバイト数より小さい場合、関数は失敗し、GetLastErrorERROR_MORE_DATA を返し、必要なサイズが pcbData パラメーターが指す変数に格納されます。

メモ

バッファーに返されたデータを処理する際、アプリケーションは返されたデータの実際のサイズを使用する必要があります。実際のサイズは、入力時に指定したバッファーのサイズよりわずかに小さい場合があります。(入力時には、可能な限り最大の出力データがバッファーに収まるように、通常はバッファーサイズを十分に大きく指定します。)出力時には、このパラメーターが指す変数が、バッファーにコピーされたデータの実際のサイズを反映するように更新されます。

戻り値の型: BOOL

公式ドキュメント

証明書コンテキストの拡張プロパティに格納されている情報を取得します。

戻り値

関数が成功すると、TRUE を返します。

関数が失敗すると、FALSE を返します。拡張エラー情報を取得するには、GetLastError を呼び出します。

発生し得るエラーコードを次に示します。

戻り値コード 説明
CRYPT_E_NOT_FOUND 証明書に指定したプロパティが存在しません。
ERROR_MORE_DATA pvData パラメーターで指定したバッファーが、返されるデータを格納するのに十分な大きさでない場合、関数は ERROR_MORE_DATA コードを設定し、必要なバッファーサイズ(バイト単位)を pcbData が指す変数に格納します。

呼び出された関数 CryptHashCertificate からのエラーがこの関数に伝播されることがあります。

解説(Remarks)

プロパティは証明書の内部には格納されません。通常、証明書応答を受信した後に証明書に関連付けられ、ストア内の証明書とともに保存されます。セキュリティ上の理由から、保存する前にプロパティ値を検証し、ユーザーストアには CERT_FRIENDLY_NAME_PROP_ID 値などの情報プロパティのみを保存することをお勧めします。その他すべてのプロパティの種類は、ローカルコンピューターストアに保存する必要があります。

コードでは、マクロを使用して証明書コンテキストのハッシュのクラスを評価できます。詳細については、CertSetCertificateContextProperty を参照してください。

この関数を使用する例については、「Example C Program: Getting and Setting Certificate Properties」および「Example C Program: Listing the Certificates in a Store」を参照してください。

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

各言語での呼び出し定義

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

BOOL CertGetCertificateContextProperty(
    const CERT_CONTEXT* pCertContext,
    DWORD dwPropId,
    void* pvData,   // optional
    DWORD* pcbData
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool CertGetCertificateContextProperty(
    IntPtr pCertContext,   // CERT_CONTEXT*
    uint dwPropId,   // DWORD
    IntPtr pvData,   // void* optional, out
    ref uint pcbData   // DWORD* in/out
);
<DllImport("CRYPT32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CertGetCertificateContextProperty(
    pCertContext As IntPtr,   ' CERT_CONTEXT*
    dwPropId As UInteger,   ' DWORD
    pvData As IntPtr,   ' void* optional, out
    ByRef pcbData As UInteger   ' DWORD* in/out
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function
' pCertContext : CERT_CONTEXT*
' dwPropId : DWORD
' pvData : void* optional, out
' pcbData : DWORD* in/out
Declare PtrSafe Function CertGetCertificateContextProperty Lib "crypt32" ( _
    ByVal pCertContext As LongPtr, _
    ByVal dwPropId As Long, _
    ByVal pvData As LongPtr, _
    ByRef pcbData As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CertGetCertificateContextProperty = ctypes.windll.crypt32.CertGetCertificateContextProperty
CertGetCertificateContextProperty.restype = wintypes.BOOL
CertGetCertificateContextProperty.argtypes = [
    ctypes.c_void_p,  # pCertContext : CERT_CONTEXT*
    wintypes.DWORD,  # dwPropId : DWORD
    ctypes.POINTER(None),  # pvData : void* optional, out
    ctypes.POINTER(wintypes.DWORD),  # pcbData : DWORD* in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPT32.dll')
CertGetCertificateContextProperty = Fiddle::Function.new(
  lib['CertGetCertificateContextProperty'],
  [
    Fiddle::TYPE_VOIDP,  # pCertContext : CERT_CONTEXT*
    -Fiddle::TYPE_INT,  # dwPropId : DWORD
    Fiddle::TYPE_VOIDP,  # pvData : void* optional, out
    Fiddle::TYPE_VOIDP,  # pcbData : DWORD* in/out
  ],
  Fiddle::TYPE_INT)
#[link(name = "crypt32")]
extern "system" {
    fn CertGetCertificateContextProperty(
        pCertContext: *const CERT_CONTEXT,  // CERT_CONTEXT*
        dwPropId: u32,  // DWORD
        pvData: *mut (),  // void* optional, out
        pcbData: *mut u32  // DWORD* in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", SetLastError = true)]
public static extern bool CertGetCertificateContextProperty(IntPtr pCertContext, uint dwPropId, IntPtr pvData, ref uint pcbData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertGetCertificateContextProperty' -Namespace Win32 -PassThru
# $api::CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
#uselib "CRYPT32.dll"
#func global CertGetCertificateContextProperty "CertGetCertificateContextProperty" sptr, sptr, sptr, sptr
; CertGetCertificateContextProperty varptr(pCertContext), dwPropId, pvData, varptr(pcbData)   ; 戻り値は stat
; pCertContext : CERT_CONTEXT* -> "sptr"
; dwPropId : DWORD -> "sptr"
; pvData : void* optional, out -> "sptr"
; pcbData : DWORD* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "CRYPT32.dll"
#cfunc global CertGetCertificateContextProperty "CertGetCertificateContextProperty" var, int, sptr, var
; res = CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
; pCertContext : CERT_CONTEXT* -> "var"
; dwPropId : DWORD -> "int"
; pvData : void* optional, out -> "sptr"
; pcbData : DWORD* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL CertGetCertificateContextProperty(CERT_CONTEXT* pCertContext, DWORD dwPropId, void* pvData, DWORD* pcbData)
#uselib "CRYPT32.dll"
#cfunc global CertGetCertificateContextProperty "CertGetCertificateContextProperty" var, int, intptr, var
; res = CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
; pCertContext : CERT_CONTEXT* -> "var"
; dwPropId : DWORD -> "int"
; pvData : void* optional, out -> "intptr"
; pcbData : DWORD* in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
	procCertGetCertificateContextProperty = crypt32.NewProc("CertGetCertificateContextProperty")
)

// pCertContext (CERT_CONTEXT*), dwPropId (DWORD), pvData (void* optional, out), pcbData (DWORD* in/out)
r1, _, err := procCertGetCertificateContextProperty.Call(
	uintptr(pCertContext),
	uintptr(dwPropId),
	uintptr(pvData),
	uintptr(pcbData),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function CertGetCertificateContextProperty(
  pCertContext: Pointer;   // CERT_CONTEXT*
  dwPropId: DWORD;   // DWORD
  pvData: Pointer;   // void* optional, out
  pcbData: Pointer   // DWORD* in/out
): BOOL; stdcall;
  external 'CRYPT32.dll' name 'CertGetCertificateContextProperty';
result := DllCall("CRYPT32\CertGetCertificateContextProperty"
    , "Ptr", pCertContext   ; CERT_CONTEXT*
    , "UInt", dwPropId   ; DWORD
    , "Ptr", pvData   ; void* optional, out
    , "Ptr", pcbData   ; DWORD* in/out
    , "Int")   ; return: BOOL
●CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData) = DLL("CRYPT32.dll", "bool CertGetCertificateContextProperty(void*, dword, void*, void*)")
# 呼び出し: CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
# pCertContext : CERT_CONTEXT* -> "void*"
# dwPropId : DWORD -> "dword"
# pvData : void* optional, out -> "void*"
# pcbData : DWORD* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "crypt32" fn CertGetCertificateContextProperty(
    pCertContext: [*c]CERT_CONTEXT, // CERT_CONTEXT*
    dwPropId: u32, // DWORD
    pvData: ?*anyopaque, // void* optional, out
    pcbData: [*c]u32 // DWORD* in/out
) callconv(std.os.windows.WINAPI) i32;
proc CertGetCertificateContextProperty(
    pCertContext: ptr CERT_CONTEXT,  # CERT_CONTEXT*
    dwPropId: uint32,  # DWORD
    pvData: pointer,  # void* optional, out
    pcbData: ptr uint32  # DWORD* in/out
): int32 {.importc: "CertGetCertificateContextProperty", stdcall, dynlib: "CRYPT32.dll".}
pragma(lib, "crypt32");
extern(Windows)
int CertGetCertificateContextProperty(
    CERT_CONTEXT* pCertContext,   // CERT_CONTEXT*
    uint dwPropId,   // DWORD
    void* pvData,   // void* optional, out
    uint* pcbData   // DWORD* in/out
);
ccall((:CertGetCertificateContextProperty, "CRYPT32.dll"), stdcall, Int32,
      (Ptr{CERT_CONTEXT}, UInt32, Ptr{Cvoid}, Ptr{UInt32}),
      pCertContext, dwPropId, pvData, pcbData)
# pCertContext : CERT_CONTEXT* -> Ptr{CERT_CONTEXT}
# dwPropId : DWORD -> UInt32
# pvData : void* optional, out -> Ptr{Cvoid}
# pcbData : DWORD* in/out -> Ptr{UInt32}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t CertGetCertificateContextProperty(
    void* pCertContext,
    uint32_t dwPropId,
    void* pvData,
    uint32_t* pcbData);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
-- pCertContext : CERT_CONTEXT*
-- dwPropId : DWORD
-- pvData : void* optional, out
-- pcbData : DWORD* in/out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CertGetCertificateContextProperty = lib.func('__stdcall', 'CertGetCertificateContextProperty', 'int32_t', ['void *', 'uint32_t', 'void *', 'uint32_t *']);
// CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
// pCertContext : CERT_CONTEXT* -> 'void *'
// dwPropId : DWORD -> 'uint32_t'
// pvData : void* optional, out -> 'void *'
// pcbData : DWORD* in/out -> 'uint32_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("CRYPT32.dll", {
  CertGetCertificateContextProperty: { parameters: ["pointer", "u32", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData)
// pCertContext : CERT_CONTEXT* -> "pointer"
// dwPropId : DWORD -> "u32"
// pvData : void* optional, out -> "pointer"
// pcbData : DWORD* in/out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t CertGetCertificateContextProperty(
    void* pCertContext,
    uint32_t dwPropId,
    void* pvData,
    uint32_t* pcbData);
C, "CRYPT32.dll");
// $ffi->CertGetCertificateContextProperty(pCertContext, dwPropId, pvData, pcbData);
// pCertContext : CERT_CONTEXT*
// dwPropId : DWORD
// pvData : void* optional, out
// pcbData : DWORD* in/out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Crypt32 extends StdCallLibrary {
    Crypt32 INSTANCE = Native.load("crypt32", Crypt32.class);
    boolean CertGetCertificateContextProperty(
        Pointer pCertContext,   // CERT_CONTEXT*
        int dwPropId,   // DWORD
        Pointer pvData,   // void* optional, out
        IntByReference pcbData   // DWORD* in/out
    );
}
@[Link("crypt32")]
lib LibCRYPT32
  fun CertGetCertificateContextProperty = CertGetCertificateContextProperty(
    pCertContext : CERT_CONTEXT*,   # CERT_CONTEXT*
    dwPropId : UInt32,   # DWORD
    pvData : Void*,   # void* optional, out
    pcbData : UInt32*   # DWORD* in/out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef CertGetCertificateContextPropertyNative = Int32 Function(Pointer<Void>, Uint32, Pointer<Void>, Pointer<Uint32>);
typedef CertGetCertificateContextPropertyDart = int Function(Pointer<Void>, int, Pointer<Void>, Pointer<Uint32>);
final CertGetCertificateContextProperty = DynamicLibrary.open('CRYPT32.dll')
    .lookupFunction<CertGetCertificateContextPropertyNative, CertGetCertificateContextPropertyDart>('CertGetCertificateContextProperty');
// pCertContext : CERT_CONTEXT* -> Pointer<Void>
// dwPropId : DWORD -> Uint32
// pvData : void* optional, out -> Pointer<Void>
// pcbData : DWORD* in/out -> Pointer<Uint32>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function CertGetCertificateContextProperty(
  pCertContext: Pointer;   // CERT_CONTEXT*
  dwPropId: DWORD;   // DWORD
  pvData: Pointer;   // void* optional, out
  pcbData: Pointer   // DWORD* in/out
): BOOL; stdcall;
  external 'CRYPT32.dll' name 'CertGetCertificateContextProperty';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "CertGetCertificateContextProperty"
  c_CertGetCertificateContextProperty :: Ptr () -> Word32 -> Ptr () -> Ptr Word32 -> IO CInt
-- pCertContext : CERT_CONTEXT* -> Ptr ()
-- dwPropId : DWORD -> Word32
-- pvData : void* optional, out -> Ptr ()
-- pcbData : DWORD* in/out -> Ptr Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let certgetcertificatecontextproperty =
  foreign "CertGetCertificateContextProperty"
    ((ptr void) @-> uint32_t @-> (ptr void) @-> (ptr uint32_t) @-> returning int32_t)
(* pCertContext : CERT_CONTEXT* -> (ptr void) *)
(* dwPropId : DWORD -> uint32_t *)
(* pvData : void* optional, out -> (ptr void) *)
(* pcbData : DWORD* in/out -> (ptr uint32_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)

(cffi:defcfun ("CertGetCertificateContextProperty" cert-get-certificate-context-property :convention :stdcall) :int32
  (p-cert-context :pointer)   ; CERT_CONTEXT*
  (dw-prop-id :uint32)   ; DWORD
  (pv-data :pointer)   ; void* optional, out
  (pcb-data :pointer))   ; DWORD* in/out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $CertGetCertificateContextProperty = Win32::API::More->new('CRYPT32',
    'BOOL CertGetCertificateContextProperty(LPVOID pCertContext, DWORD dwPropId, LPVOID pvData, LPVOID pcbData)');
# my $ret = $CertGetCertificateContextProperty->Call($pCertContext, $dwPropId, $pvData, $pcbData);
# pCertContext : CERT_CONTEXT* -> LPVOID
# dwPropId : DWORD -> DWORD
# pvData : void* optional, out -> LPVOID
# pcbData : DWORD* in/out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

使用する型