CertSetCertificateContextProperty
関数シグネチャ
// CRYPT32.dll
#include <windows.h>
BOOL CertSetCertificateContextProperty(
const CERT_CONTEXT* pCertContext,
DWORD dwPropId,
DWORD dwFlags,
const void* pvData // optional
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| pCertContext | CERT_CONTEXT* | in | CERT_CONTEXT 構造体へのポインターです。 | ||||||||||
| dwPropId | DWORD | in | 設定するプロパティです。dwPropId の値によって、pvData パラメーターの型と内容が決まります。現在定義されている識別子と、それに対応する pvData の型は次のとおりです。 CERT_ACCESS_STATE_PROP_IDpvData のデータ型: DWORD 値へのポインター。 証明書への書き込み操作が永続化されるかどうかを示す DWORD 値を返します。証明書がメモリストア内、または読み取り専用で開かれたレジストリベースのストア内にある場合、この DWORD 値は設定されません。 CERT_AIA_URL_RETRIEVED_PROP_IDこの識別子は予約されています。 CERT_ARCHIVED_KEY_HASH_PROP_IDpvData のデータ型: CRYPT_HASH_BLOB 構造体へのポインター。 このプロパティは、証明書コンテキストに対する暗号化されたキー hash を保存します。 CERT_ARCHIVED_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 列挙の際にその certificate がスキップされることを示します。このプロパティが設定された証明書も、特定の hash や特定のシリアル番号を持つ証明書を検索するなど、明示的な検索操作では引き続き見つかります。このプロパティは空の BLOB である CERT_AUTHORITY_INFO_ACCESS_PROP_IDこの識別子は予約されています。 CERT_AUTO_ENROLL_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 Auto Enroll を使用して証明書が登録された後に設定されるプロパティです。pvData が指す CRYPT_DATA_BLOB 構造体には、その証明書が自動登録された証明書の種類の名前(null 終端の Unicode 文字列)が含まれます。以降に証明書に対して Auto Enroll を呼び出すと、このプロパティをチェックして証明書が登録済みかどうかを判断します。 CERT_AUTO_ENROLL_RETRY_PROP_IDこの識別子は予約されています。 CERT_BACKED_UP_PROP_IDこの識別子は予約されています。 CERT_CA_DISABLE_CRL_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 certification authority(CA)が使用する証明書に対する certificate revocation list(CRL)の取得を無効にします。CA 証明書にこのプロパティが含まれる場合は、CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_ID プロパティも含める必要があります。 CERT_CA_OCSP_AUTHORITY_INFO_ACCESS_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CA 証明書によって発行された証明書に使用する online certificate status protocol(OCSP)URL のリストが含まれます。配列の内容は、pszAccessMethod が szOID_PKIX_OCSP に設定された X509_AUTHORITY_INFO_ACCESS 構造体の Abstract Syntax Notation One(ASN.1)エンコードされたバイト列です。 CERT_CROSS_CERT_DIST_POINTS_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 クロス証明書の場所を設定します。この値は証明書にのみ適用され、certificate revocation lists(CRL)や certificate trust lists(CTL)には適用されません。CRYPT_DATA_BLOB 構造体には、lpszStuctType パラメーターに X509_CROSS_CERT_DIST_POINTS 値を指定して CryptEncodeObject 関数でエンコードされた、Abstract Syntax Notation One(ASN.1)エンコードの CROSS_CERT_DIST_POINTS_INFO 構造体が含まれます。 CERT_CTL_USAGE_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体には、ASN.1 エンコードの CTL_USAGE 構造体が含まれます。この構造体は、X509_ENHANCED_KEY_USAGE 値を設定して CryptEncodeObject 関数でエンコードされます。 CERT_DATE_STAMP_PROP_IDpvData のデータ型: FILETIME 構造体へのポインター。 このプロパティは、証明書がストアに追加された時刻を設定します。 CERT_DESCRIPTION_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 証明書 UI によって設定および表示されるプロパティです。このプロパティにより、ユーザーは証明書の用途を記述できます。 CERT_EFS_PROP_IDこの識別子は予約されています。 CERT_ENHKEY_USAGE_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 pvData パラメーターが、ASN.1 エンコードの CERT_ENHKEY_USAGE 構造体を含む CRYPT_DATA_BLOB 構造体を指すことを示すプロパティです。この構造体は、X509_ENHANCED_KEY_USAGE 値を設定して CryptEncodeObject 関数でエンコードされます。 CERT_ENROLLMENT_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 RequestID、CADNSName、CAName、DisplayName を含む、保留中の要求の登録情報です。データ形式は次のように定義されています。
CERT_EXTENDED_ERROR_INFO_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、証明書コンテキストの拡張エラー情報を含む文字列を設定します。 CERT_FORTEZZA_DATA_PROP_IDこの識別子は予約されています。 CERT_FRIENDLY_NAME_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体には、証明書の表示名が含まれます。 CERT_HASH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 CERT_HCRYPTPROV_OR_NCRYPT_KEY_HANDLE_PROP_IDpvData のデータ型: HCRYPTPROV_OR_NCRYPT_KEY_HANDLE データ型へのポインター。 このプロパティは NCryptIsKeyHandle を呼び出して、これが NCRYPT_KEY_HANDLE かどうかを判定します。NCRYPT_KEY_HANDLE の場合は CERT_NCRYPT_KEY_HANDLE_PROP_ID を設定し、そうでない場合は CERT_KEY_PROV_HANDLE_PROP_ID を設定します。 CERT_HCRYPTPROV_TRANSFER_PROP_ID証明書に関連付けられた CAPI キーのハンドルを設定します。 CERT_IE30_RESERVED_PROP_IDこの識別子は予約されています。 CERT_ISSUER_PUBLIC_KEY_MD5_HASH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、この証明書の署名に使用された private key に関連付けられた public key の MD5 hash を設定します。 CERT_ISSUER_SERIAL_NUMBER_MD5_HASH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体には、この証明書の発行者名とシリアル番号の MD5 ハッシュが含まれます。 CERT_KEY_CONTEXT_PROP_IDpvData のデータ型: CERT_KEY_CONTEXT 構造体へのポインター。 この構造体は証明書の秘密キーを指定します。秘密キーの HCRYPTPROV とキー仕様の両方が含まれます。hCryptProv メンバーと dwFlags の設定の詳細については、このトピックの後半の CERT_KEY_PROV_HANDLE_PROP_ID を参照してください。 注意 このプロパティでは、CERT_KEY_CONTEXT 構造体のメンバーが追加される場合があります。その場合、cbSize メンバーの値はそれに応じて調整されます。cbSize メンバーは CERT_KEY_CONTEXT 構造体のサイズに設定する必要があります。
CERT_KEY_IDENTIFIER_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは通常、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 CERT_KEY_PROV_HANDLE_PROP_IDpvData のデータ型: HCRYPTPROV 値。 証明書の秘密キーの HCRYPTPROV ハンドルが設定されます。CERT_KEY_CONTEXT 構造体の hCryptProv メンバーが存在する場合は更新されます。存在しない場合は、dwKeySpec を使用して作成され、CERT_KEY_PROV_INFO_PROP_ID によって初期化されます。CERT_STORE_NO_CRYPT_RELEASE_FLAG が設定されていない場合、hCryptProv の値は、プロパティが NULL に設定されたとき、または CERT_CONTEXT 構造体の最終的な解放時に暗黙的に解放されます。 CERT_KEY_PROV_INFO_PROP_IDpvData のデータ型: CRYPT_KEY_PROV_INFO 構造体へのポインター。 この構造体は証明書の秘密キーを指定します。 CERT_KEY_SPEC_PROP_IDpvData のデータ型: DWORD 値へのポインター。 秘密キーを指定する DWORD 値です。CERT_KEY_CONTEXT 構造体の dwKeySpec メンバーが存在する場合は更新されます。存在しない場合は、hCryptProv を 0 に設定して作成されます。 CERT_MD5_HASH_PROP_IDpvData のデータ型: CRYPT_HASH_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 CERT_NCRYPT_KEY_HANDLE_PROP_IDpvData のデータ型: NCRYPT_KEY_HANDLE データ型へのポインター。 このプロパティは、証明書の秘密キーに対する NCRYPT_KEY_HANDLE を設定し、dwKeySpec を CERT_NCRYPT_KEY_SPEC に設定します。 CERT_NCRYPT_KEY_HANDLE_TRANSFER_PROP_ID証明書に関連付けられた CNG キーのハンドルを設定します。 CERT_NEW_KEY_PROP_IDこの識別子は予約されています。 CERT_NEXT_UPDATE_LOCATION_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体には、X509_ALTERNATE_NAME 値を設定して CryptEncodeObject 関数でエンコードされた、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_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、この証明書の CERT_SERVER_OCSP_RESPONSE_CONTEXT から、エンコードされた online certificate status protocol(OCSP)応答を設定します。 CERT_PUB_KEY_CNG_ALG_BIT_LENGTH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この識別子はサポートされていません。 CERT_PUBKEY_ALG_PARA_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、アルゴリズムパラメーターの継承をサポートする公開キーで使用します。データ BLOB には、ASN.1 エンコードの PublicKey アルゴリズムパラメーターが含まれます。DSS の場合、これらは CryptEncodeObject 関数を使用してエンコードされたパラメーターです。これは CMS_PKCS7 が定義されている場合にのみ使用されます。 CERT_PUBKEY_HASH_RESERVED_PROP_IDこの識別子は予約されています。 CERT_PVK_FILE_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体は、証明書の公開キーに関連付けられた秘密キーを含むファイルの名前を指定します。CRYPT_DATA_BLOB 構造体内では、pbData メンバーが null 終端の Unicode ワイド文字列へのポインターであり、cbData メンバーがその文字列の長さを示します。 CERT_RENEWAL_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、更新された証明書のハッシュを指定します。 CERT_REQUEST_ORIGINATOR_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 CRYPT_DATA_BLOB 構造体には、証明書コンテキスト要求の発信元の DNS コンピューター名を含む null 終端の Unicode 文字列が含まれます。 CERT_ROOT_PROGRAM_CERT_POLICIES_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 コンテキストのルート証明書のアプリケーションポリシーを含む、エンコードされた CERT_POLICIES_INFO 構造体へのポインターを返します。このプロパティは、lpszStructType パラメーターを X509_CERT_POLICIES に、dwCertEncodingType パラメーターを X509_ASN_ENCODING と PKCS_7_ASN_ENCODING のビット単位 OR の組み合わせに設定して、CryptDecodeObject 関数を使用してデコードできます。 CERT_ROOT_PROGRAM_NAME_CONSTRAINTS_PROP_IDこの識別子は予約されています。 CERT_SIGN_HASH_CNG_ALG_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この識別子はサポートされていません。 CERT_SHA1_HASH_PROP_IDpvData のデータ型: CRYPT_HASH_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 CERT_SIGNATURE_HASH_PROP_IDpvData のデータ型: CRYPT_HASH_BLOB 構造体へのポインター。 署名ハッシュが存在しない場合は、CryptHashToBeSigned 関数を使用して計算されます。pvData は、既存または計算されたハッシュを指します。通常、ハッシュの長さは SHA の場合 20 バイト、MD5 の場合 16 バイトです。 CERT_SMART_CARD_DATA_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、スマートカード証明書コンテキストのスマートカードデータプロパティを設定します。 CERT_SMART_CARD_ROOT_INFO_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、スマートカードルート証明書コンテキストの情報プロパティを設定します。 CERT_SOURCE_LOCATION_PROP_IDこの識別子は予約されています。 CERT_SOURCE_URL_PROP_IDこの識別子は予約されています。 CERT_SUBJECT_DISABLE_CRL_PROP_IDこの識別子は予約されています。 CERT_SUBJECT_INFO_ACCESS_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、証明書コンテキストの subject information access 拡張を、エンコードされた CERT_SUBJECT_INFO_ACCESS 構造体として設定します。 CERT_SUBJECT_NAME_MD5_HASH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 証明書コンテキストのエンコードされたサブジェクト名の MD5 ハッシュを返します。 CERT_SUBJECT_OCSP_AUTHORITY_INFO_ACCESS_PROP_IDこの識別子は予約されています。 CERT_SUBJECT_PUB_KEY_BIT_LENGTH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、CertGetCertificateContextProperty 関数の呼び出しによって暗黙的に設定されます。 Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この識別子はサポートされていません。 CERT_SUBJECT_PUBLIC_KEY_MD5_HASH_PROP_IDpvData のデータ型: CRYPT_DATA_BLOB 構造体へのポインター。 このプロパティは、この証明書の公開キーの MD5 ハッシュを設定します。 pvData は CRYPT_DATA_BLOB 構造体へのポインターです。 ユーザーは、CERT_FIRST_USER_PROP_ID から CERT_LAST_USER_PROP_ID までの DWORD 値を使用して、追加の dwPropId 型を定義できます。すべてのユーザー定義 dwPropId 型では、pvData はエンコードされた CRYPT_DATA_BLOB 構造体を指します。 | ||||||||||
| dwFlags | DWORD | in | CERT_KEY_PROV_HANDLE_PROP_ID または CERT_KEY_CONTEXT_PROP_ID の dwPropId プロパティに対しては、CERT_STORE_NO_CRYPT_RELEASE_FLAG を設定できます。 CERT_SET_PROPERTY_IGNORE_PERSIST_ERROR_FLAG 値が設定されている場合、プロバイダーへの書き込みエラーはすべて無視され、キャッシュされたコンテキストのプロパティが常に設定されます。 CERT_SET_PROPERTY_INHIBIT_PERSIST_FLAG が設定されている場合、設定されたコンテキストプロパティは永続化されません。 | ||||||||||
| pvData | void* | inoptional | dwPropId の値によって決まるデータ型へのポインターです。 注意 いずれの dwPropId でも、pvData を NULL に設定するとそのプロパティが削除されます。
|
戻り値の型: BOOL
公式ドキュメント
指定した証明書コンテキストに拡張プロパティを設定します。
戻り値
関数が成功した場合は TRUE を返します。
関数が失敗した場合は FALSE を返します。拡張エラー情報を取得するには、 GetLastError を呼び出します。考えられるエラーコードの 1 つは次のとおりです。
| 戻り値コード | 説明 |
|---|---|
| プロパティが有効ではありません。指定された識別子が 0x0000FFFF より大きいか、または CERT_KEY_CONTEXT_PROP_ID プロパティで、CERT_KEY_CONTEXT 構造体に無効な cbSize メンバーが指定されました。 |
解説(Remarks)
プロパティが既に存在する場合、その古い値は置き換えられます。
コードでは、マクロを使用して証明書コンテキストのハッシュのクラスを評価できます。Wincrypt.h ヘッダーでは、この目的のために次のマクロが定義されています。これらのマクロは CertSetCertificateContextProperty 関数によって内部的に使用されます。
IS_CERT_HASH_PROP_ID(X) IS_PUBKEY_HASH_PROP_ID(X) IS_CHAIN_HASH_PROP_ID(X) 各マクロは dwPropId(X)の値を入力として受け取り、ブール値に評価されます。次の表は、各マクロで TRUE に評価される dwPropId の値を示しています。
| マクロ | dwPropId が次の場合に TRUE に評価される |
|---|---|
| IS_CERT_HASH_PROP_ID(dwPropId) | |
| IS_PUBKEY_HASH_PROP_ID(dwPropId) | |
| IS_CHAIN_HASH_PROP_ID(dwPropId) |
IS_STRONG_SIGN_PROP_ID(x) マクロは、dwPropId パラメーターに CERT_SIGN_HASH_CNG_ALG_PROP_ID、 CERT_SUBJECT_PUB_KEY_BIT_LENGTH_PROP_ID、または CERT_PUB_KEY_CNG_ALG_BIT_LENGTH_PROP_ID プロパティが設定されている場合に TRUE に評価されます。
例
この関数を使用する例については、 Example C Program: Getting and Setting Certificate Properties を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// CRYPT32.dll
#include <windows.h>
BOOL CertSetCertificateContextProperty(
const CERT_CONTEXT* pCertContext,
DWORD dwPropId,
DWORD dwFlags,
const void* pvData // optional
);[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", SetLastError = true, ExactSpelling = true)]
static extern bool CertSetCertificateContextProperty(
IntPtr pCertContext, // CERT_CONTEXT*
uint dwPropId, // DWORD
uint dwFlags, // DWORD
IntPtr pvData // void* optional
);<DllImport("CRYPT32.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CertSetCertificateContextProperty(
pCertContext As IntPtr, ' CERT_CONTEXT*
dwPropId As UInteger, ' DWORD
dwFlags As UInteger, ' DWORD
pvData As IntPtr ' void* optional
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function' pCertContext : CERT_CONTEXT*
' dwPropId : DWORD
' dwFlags : DWORD
' pvData : void* optional
Declare PtrSafe Function CertSetCertificateContextProperty Lib "crypt32" ( _
ByVal pCertContext As LongPtr, _
ByVal dwPropId As Long, _
ByVal dwFlags As Long, _
ByVal pvData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CertSetCertificateContextProperty = ctypes.windll.crypt32.CertSetCertificateContextProperty
CertSetCertificateContextProperty.restype = wintypes.BOOL
CertSetCertificateContextProperty.argtypes = [
ctypes.c_void_p, # pCertContext : CERT_CONTEXT*
wintypes.DWORD, # dwPropId : DWORD
wintypes.DWORD, # dwFlags : DWORD
ctypes.POINTER(None), # pvData : void* optional
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('CRYPT32.dll')
CertSetCertificateContextProperty = Fiddle::Function.new(
lib['CertSetCertificateContextProperty'],
[
Fiddle::TYPE_VOIDP, # pCertContext : CERT_CONTEXT*
-Fiddle::TYPE_INT, # dwPropId : DWORD
-Fiddle::TYPE_INT, # dwFlags : DWORD
Fiddle::TYPE_VOIDP, # pvData : void* optional
],
Fiddle::TYPE_INT)#[link(name = "crypt32")]
extern "system" {
fn CertSetCertificateContextProperty(
pCertContext: *const CERT_CONTEXT, // CERT_CONTEXT*
dwPropId: u32, // DWORD
dwFlags: u32, // DWORD
pvData: *const () // void* optional
) -> 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 CertSetCertificateContextProperty(IntPtr pCertContext, uint dwPropId, uint dwFlags, IntPtr pvData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertSetCertificateContextProperty' -Namespace Win32 -PassThru
# $api::CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData)#uselib "CRYPT32.dll"
#func global CertSetCertificateContextProperty "CertSetCertificateContextProperty" sptr, sptr, sptr, sptr
; CertSetCertificateContextProperty varptr(pCertContext), dwPropId, dwFlags, pvData ; 戻り値は stat
; pCertContext : CERT_CONTEXT* -> "sptr"
; dwPropId : DWORD -> "sptr"
; dwFlags : DWORD -> "sptr"
; pvData : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "CRYPT32.dll" #cfunc global CertSetCertificateContextProperty "CertSetCertificateContextProperty" var, int, int, sptr ; res = CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData) ; pCertContext : CERT_CONTEXT* -> "var" ; dwPropId : DWORD -> "int" ; dwFlags : DWORD -> "int" ; pvData : void* optional -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPT32.dll" #cfunc global CertSetCertificateContextProperty "CertSetCertificateContextProperty" sptr, int, int, sptr ; res = CertSetCertificateContextProperty(varptr(pCertContext), dwPropId, dwFlags, pvData) ; pCertContext : CERT_CONTEXT* -> "sptr" ; dwPropId : DWORD -> "int" ; dwFlags : DWORD -> "int" ; pvData : void* optional -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; BOOL CertSetCertificateContextProperty(CERT_CONTEXT* pCertContext, DWORD dwPropId, DWORD dwFlags, void* pvData) #uselib "CRYPT32.dll" #cfunc global CertSetCertificateContextProperty "CertSetCertificateContextProperty" var, int, int, intptr ; res = CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData) ; pCertContext : CERT_CONTEXT* -> "var" ; dwPropId : DWORD -> "int" ; dwFlags : DWORD -> "int" ; pvData : void* optional -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL CertSetCertificateContextProperty(CERT_CONTEXT* pCertContext, DWORD dwPropId, DWORD dwFlags, void* pvData) #uselib "CRYPT32.dll" #cfunc global CertSetCertificateContextProperty "CertSetCertificateContextProperty" intptr, int, int, intptr ; res = CertSetCertificateContextProperty(varptr(pCertContext), dwPropId, dwFlags, pvData) ; pCertContext : CERT_CONTEXT* -> "intptr" ; dwPropId : DWORD -> "int" ; dwFlags : DWORD -> "int" ; pvData : void* optional -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
procCertSetCertificateContextProperty = crypt32.NewProc("CertSetCertificateContextProperty")
)
// pCertContext (CERT_CONTEXT*), dwPropId (DWORD), dwFlags (DWORD), pvData (void* optional)
r1, _, err := procCertSetCertificateContextProperty.Call(
uintptr(pCertContext),
uintptr(dwPropId),
uintptr(dwFlags),
uintptr(pvData),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // BOOLfunction CertSetCertificateContextProperty(
pCertContext: Pointer; // CERT_CONTEXT*
dwPropId: DWORD; // DWORD
dwFlags: DWORD; // DWORD
pvData: Pointer // void* optional
): BOOL; stdcall;
external 'CRYPT32.dll' name 'CertSetCertificateContextProperty';result := DllCall("CRYPT32\CertSetCertificateContextProperty"
, "Ptr", pCertContext ; CERT_CONTEXT*
, "UInt", dwPropId ; DWORD
, "UInt", dwFlags ; DWORD
, "Ptr", pvData ; void* optional
, "Int") ; return: BOOL●CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData) = DLL("CRYPT32.dll", "bool CertSetCertificateContextProperty(void*, dword, dword, void*)")
# 呼び出し: CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData)
# pCertContext : CERT_CONTEXT* -> "void*"
# dwPropId : DWORD -> "dword"
# dwFlags : DWORD -> "dword"
# pvData : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "crypt32" fn CertSetCertificateContextProperty(
pCertContext: [*c]CERT_CONTEXT, // CERT_CONTEXT*
dwPropId: u32, // DWORD
dwFlags: u32, // DWORD
pvData: ?*anyopaque // void* optional
) callconv(std.os.windows.WINAPI) i32;proc CertSetCertificateContextProperty(
pCertContext: ptr CERT_CONTEXT, # CERT_CONTEXT*
dwPropId: uint32, # DWORD
dwFlags: uint32, # DWORD
pvData: pointer # void* optional
): int32 {.importc: "CertSetCertificateContextProperty", stdcall, dynlib: "CRYPT32.dll".}pragma(lib, "crypt32");
extern(Windows)
int CertSetCertificateContextProperty(
CERT_CONTEXT* pCertContext, // CERT_CONTEXT*
uint dwPropId, // DWORD
uint dwFlags, // DWORD
void* pvData // void* optional
);ccall((:CertSetCertificateContextProperty, "CRYPT32.dll"), stdcall, Int32,
(Ptr{CERT_CONTEXT}, UInt32, UInt32, Ptr{Cvoid}),
pCertContext, dwPropId, dwFlags, pvData)
# pCertContext : CERT_CONTEXT* -> Ptr{CERT_CONTEXT}
# dwPropId : DWORD -> UInt32
# dwFlags : DWORD -> UInt32
# pvData : void* optional -> Ptr{Cvoid}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t CertSetCertificateContextProperty(
void* pCertContext,
uint32_t dwPropId,
uint32_t dwFlags,
void* pvData);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData)
-- pCertContext : CERT_CONTEXT*
-- dwPropId : DWORD
-- dwFlags : DWORD
-- pvData : void* optional
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CertSetCertificateContextProperty = lib.func('__stdcall', 'CertSetCertificateContextProperty', 'int32_t', ['void *', 'uint32_t', 'uint32_t', 'void *']);
// CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData)
// pCertContext : CERT_CONTEXT* -> 'void *'
// dwPropId : DWORD -> 'uint32_t'
// dwFlags : DWORD -> 'uint32_t'
// pvData : void* optional -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("CRYPT32.dll", {
CertSetCertificateContextProperty: { parameters: ["pointer", "u32", "u32", "pointer"], result: "i32" },
});
// lib.symbols.CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData)
// pCertContext : CERT_CONTEXT* -> "pointer"
// dwPropId : DWORD -> "u32"
// dwFlags : DWORD -> "u32"
// pvData : void* optional -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t CertSetCertificateContextProperty(
void* pCertContext,
uint32_t dwPropId,
uint32_t dwFlags,
void* pvData);
C, "CRYPT32.dll");
// $ffi->CertSetCertificateContextProperty(pCertContext, dwPropId, dwFlags, pvData);
// pCertContext : CERT_CONTEXT*
// dwPropId : DWORD
// dwFlags : DWORD
// pvData : void* optional
// 構造体/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 CertSetCertificateContextProperty(
Pointer pCertContext, // CERT_CONTEXT*
int dwPropId, // DWORD
int dwFlags, // DWORD
Pointer pvData // void* optional
);
}@[Link("crypt32")]
lib LibCRYPT32
fun CertSetCertificateContextProperty = CertSetCertificateContextProperty(
pCertContext : CERT_CONTEXT*, # CERT_CONTEXT*
dwPropId : UInt32, # DWORD
dwFlags : UInt32, # DWORD
pvData : Void* # void* optional
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef CertSetCertificateContextPropertyNative = Int32 Function(Pointer<Void>, Uint32, Uint32, Pointer<Void>);
typedef CertSetCertificateContextPropertyDart = int Function(Pointer<Void>, int, int, Pointer<Void>);
final CertSetCertificateContextProperty = DynamicLibrary.open('CRYPT32.dll')
.lookupFunction<CertSetCertificateContextPropertyNative, CertSetCertificateContextPropertyDart>('CertSetCertificateContextProperty');
// pCertContext : CERT_CONTEXT* -> Pointer<Void>
// dwPropId : DWORD -> Uint32
// dwFlags : DWORD -> Uint32
// pvData : void* optional -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function CertSetCertificateContextProperty(
pCertContext: Pointer; // CERT_CONTEXT*
dwPropId: DWORD; // DWORD
dwFlags: DWORD; // DWORD
pvData: Pointer // void* optional
): BOOL; stdcall;
external 'CRYPT32.dll' name 'CertSetCertificateContextProperty';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "CertSetCertificateContextProperty"
c_CertSetCertificateContextProperty :: Ptr () -> Word32 -> Word32 -> Ptr () -> IO CInt
-- pCertContext : CERT_CONTEXT* -> Ptr ()
-- dwPropId : DWORD -> Word32
-- dwFlags : DWORD -> Word32
-- pvData : void* optional -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let certsetcertificatecontextproperty =
foreign "CertSetCertificateContextProperty"
((ptr void) @-> uint32_t @-> uint32_t @-> (ptr void) @-> returning int32_t)
(* pCertContext : CERT_CONTEXT* -> (ptr void) *)
(* dwPropId : DWORD -> uint32_t *)
(* dwFlags : DWORD -> uint32_t *)
(* pvData : void* optional -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)
(cffi:defcfun ("CertSetCertificateContextProperty" cert-set-certificate-context-property :convention :stdcall) :int32
(p-cert-context :pointer) ; CERT_CONTEXT*
(dw-prop-id :uint32) ; DWORD
(dw-flags :uint32) ; DWORD
(pv-data :pointer)) ; void* optional
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $CertSetCertificateContextProperty = Win32::API::More->new('CRYPT32',
'BOOL CertSetCertificateContextProperty(LPVOID pCertContext, DWORD dwPropId, DWORD dwFlags, LPVOID pvData)');
# my $ret = $CertSetCertificateContextProperty->Call($pCertContext, $dwPropId, $dwFlags, $pvData);
# pCertContext : CERT_CONTEXT* -> LPVOID
# dwPropId : DWORD -> DWORD
# dwFlags : DWORD -> DWORD
# pvData : void* optional -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- s CERT_ALT_NAME_INFO
- s CTL_USAGE
- s CERT_KEY_CONTEXT
- s CROSS_CERT_DIST_POINTS_INFO
- s CRYPT_KEY_PROV_INFO
- f CertGetCertificateContextProperty — 証明書コンテキストの指定プロパティを取得する。
- f CertSetCRLContextProperty — CRLコンテキストの指定プロパティを設定する。
- f CryptEncodeObject — 暗号構造体を指定したエンコード形式に符号化する。
- f CryptHashToBeSigned — エンコードされた証明書の被署名部分のハッシュを計算する。