CertNameToStrW
関数シグネチャ
// CRYPT32.dll (Unicode / -W)
#include <windows.h>
DWORD CertNameToStrW(
CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
CRYPT_INTEGER_BLOB* pName,
CERT_STRING_TYPE dwStrType,
LPWSTR psz, // optional
DWORD csz
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwCertEncodingType | CERT_QUERY_ENCODING_TYPE | in | 名前のエンコードに使用された 証明書エンコードの種類です。この値の上位 WORD に含まれる メッセージエンコードの種類の識別子は、この関数では無視されます。 このパラメーターには、現在定義されている次の証明書エンコードの種類を指定できます。
| ||||||||||||||||||||||||
| pName | CRYPT_INTEGER_BLOB* | in | 変換対象の CERT_NAME_BLOB 構造体へのポインターです。 | ||||||||||||||||||||||||
| dwStrType | CERT_STRING_TYPE | in | このパラメーターは、出力文字列の形式を指定します。また、文字列の内容に関するその他のオプションも指定します。 このパラメーターには、次のいずれかの値を指定できます。
上記の値に加えて、文字列に関する追加オプションを指定するために、次のオプションを組み合わせることもできます。
| ||||||||||||||||||||||||
| psz | LPWSTR | outoptional | 返される文字列を受け取る文字バッファーへのポインターです。このバッファーのサイズは csz パラメーターで指定します。 | ||||||||||||||||||||||||
| csz | DWORD | in | psz バッファーのサイズ (文字数) です。このサイズには終端の NULL 文字を含める必要があります。 |
戻り値の型: DWORD
公式ドキュメント
CERT_NAME_BLOB 構造体内のエンコードされた名前を、NULL 終端の文字列に変換します。(Unicode)
戻り値
変換された文字数を、終端の NULL 文字を含めて返します。
psz が NULL の場合、または csz がゼロの場合は、変換先文字列に必要なサイズを返します。
解説(Remarks)
psz が NULL でなく、かつ csz がゼロでない場合、返される psz は常に NULL 終端の文字列になります。
デコード時に順序の問題が発生する可能性を避けるため、複数の構成要素から成る RDN (例: CN=James+O=Microsoft) は使用しないことをお勧めします。代わりに、単一の値を持つ RDN (例: CN=James, O=Microsoft) の使用を検討してください。
文字列表現は、次の一覧で説明する相違点を除き、RFC 1779 の識別名仕様に従います。
- 引用符を含む名前は、二重引用符で囲まれます。
- 空文字列は、二重引用符で囲まれます。
- 連続する空白を含む文字列は、引用符で囲まれません。
- 型が CERT_RDN_ENCODED_BLOB または CERT_RDN_OCTET_STRING の相対識別名 (RDN) の値は、16 進数で書式設定されます。
- OID に対応する X.500 名が存在しない場合は、OID の前に「OID」というプレフィックスが使用されます。
- RDN 値の先頭の空白、末尾の空白、または次のいずれかの文字が含まれる場合、RDN 値は ("\" ではなく) 二重引用符で囲まれます。
- カンマ (,)
- プラス記号 (+)
- 等号 (=)
- インチ記号 (")
- バックスラッシュ (/)
- 小なり記号 (<)
- 大なり記号 (>)
- 番号記号 (#)
- セミコロン (;)
- stateOrProvinceName (2.5.4.8) OID の X.500 キー名は "S" です。この値は、RFC 1779 の X.500 キー名 ("ST") とは異なります。
| キー | オブジェクト識別子文字列 |
|---|---|
| E | 1.2.840.113549.1.9.1 |
| T | 2.5.4.12 |
| G | 2.5.4.42 |
| I | 2.5.4.43 |
| SN | 2.5.4.4 |
例
この関数を使用する例については、
サンプル C プログラム: 証明書の名前を ASN.1 へ変換し元に戻すを参照してください。
wincrypt.h ヘッダーは CertNameToStr をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版が自動的に選択されます。エンコードに依存しないエイリアスの使用を、エンコードに依存しないコードではない箇所と混在させると、コンパイルエラーや実行時エラーを引き起こす不整合につながる可能性があります。詳細については、関数プロトタイプの規則を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// CRYPT32.dll (Unicode / -W)
#include <windows.h>
DWORD CertNameToStrW(
CERT_QUERY_ENCODING_TYPE dwCertEncodingType,
CRYPT_INTEGER_BLOB* pName,
CERT_STRING_TYPE dwStrType,
LPWSTR psz, // optional
DWORD csz
);[DllImport("CRYPT32.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern uint CertNameToStrW(
uint dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
IntPtr pName, // CRYPT_INTEGER_BLOB*
uint dwStrType, // CERT_STRING_TYPE
[MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder psz, // LPWSTR optional, out
uint csz // DWORD
);<DllImport("CRYPT32.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function CertNameToStrW(
dwCertEncodingType As UInteger, ' CERT_QUERY_ENCODING_TYPE
pName As IntPtr, ' CRYPT_INTEGER_BLOB*
dwStrType As UInteger, ' CERT_STRING_TYPE
<MarshalAs(UnmanagedType.LPWStr)> psz As System.Text.StringBuilder, ' LPWSTR optional, out
csz As UInteger ' DWORD
) As UInteger
End Function' dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
' pName : CRYPT_INTEGER_BLOB*
' dwStrType : CERT_STRING_TYPE
' psz : LPWSTR optional, out
' csz : DWORD
Declare PtrSafe Function CertNameToStrW Lib "crypt32" ( _
ByVal dwCertEncodingType As Long, _
ByVal pName As LongPtr, _
ByVal dwStrType As Long, _
ByVal psz As LongPtr, _
ByVal csz As Long) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CertNameToStrW = ctypes.windll.crypt32.CertNameToStrW
CertNameToStrW.restype = wintypes.DWORD
CertNameToStrW.argtypes = [
wintypes.DWORD, # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
ctypes.c_void_p, # pName : CRYPT_INTEGER_BLOB*
wintypes.DWORD, # dwStrType : CERT_STRING_TYPE
wintypes.LPWSTR, # psz : LPWSTR optional, out
wintypes.DWORD, # csz : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('CRYPT32.dll')
CertNameToStrW = Fiddle::Function.new(
lib['CertNameToStrW'],
[
-Fiddle::TYPE_INT, # dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
Fiddle::TYPE_VOIDP, # pName : CRYPT_INTEGER_BLOB*
-Fiddle::TYPE_INT, # dwStrType : CERT_STRING_TYPE
Fiddle::TYPE_VOIDP, # psz : LPWSTR optional, out
-Fiddle::TYPE_INT, # csz : DWORD
],
-Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"#[link(name = "crypt32")]
extern "system" {
fn CertNameToStrW(
dwCertEncodingType: u32, // CERT_QUERY_ENCODING_TYPE
pName: *mut CRYPT_INTEGER_BLOB, // CRYPT_INTEGER_BLOB*
dwStrType: u32, // CERT_STRING_TYPE
psz: *mut u16, // LPWSTR optional, out
csz: u32 // DWORD
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("CRYPT32.dll", CharSet = CharSet.Unicode)]
public static extern uint CertNameToStrW(uint dwCertEncodingType, IntPtr pName, uint dwStrType, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder psz, uint csz);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CertNameToStrW' -Namespace Win32 -PassThru
# $api::CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz)#uselib "CRYPT32.dll"
#func global CertNameToStrW "CertNameToStrW" wptr, wptr, wptr, wptr, wptr
; CertNameToStrW dwCertEncodingType, varptr(pName), dwStrType, varptr(psz), csz ; 戻り値は stat
; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "wptr"
; pName : CRYPT_INTEGER_BLOB* -> "wptr"
; dwStrType : CERT_STRING_TYPE -> "wptr"
; psz : LPWSTR optional, out -> "wptr"
; csz : DWORD -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "CRYPT32.dll" #cfunc global CertNameToStrW "CertNameToStrW" int, var, int, var, int ; res = CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz) ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; pName : CRYPT_INTEGER_BLOB* -> "var" ; dwStrType : CERT_STRING_TYPE -> "int" ; psz : LPWSTR optional, out -> "var" ; csz : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPT32.dll" #cfunc global CertNameToStrW "CertNameToStrW" int, sptr, int, sptr, int ; res = CertNameToStrW(dwCertEncodingType, varptr(pName), dwStrType, varptr(psz), csz) ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; pName : CRYPT_INTEGER_BLOB* -> "sptr" ; dwStrType : CERT_STRING_TYPE -> "int" ; psz : LPWSTR optional, out -> "sptr" ; csz : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; DWORD CertNameToStrW(CERT_QUERY_ENCODING_TYPE dwCertEncodingType, CRYPT_INTEGER_BLOB* pName, CERT_STRING_TYPE dwStrType, LPWSTR psz, DWORD csz) #uselib "CRYPT32.dll" #cfunc global CertNameToStrW "CertNameToStrW" int, var, int, var, int ; res = CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz) ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; pName : CRYPT_INTEGER_BLOB* -> "var" ; dwStrType : CERT_STRING_TYPE -> "int" ; psz : LPWSTR optional, out -> "var" ; csz : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD CertNameToStrW(CERT_QUERY_ENCODING_TYPE dwCertEncodingType, CRYPT_INTEGER_BLOB* pName, CERT_STRING_TYPE dwStrType, LPWSTR psz, DWORD csz) #uselib "CRYPT32.dll" #cfunc global CertNameToStrW "CertNameToStrW" int, intptr, int, intptr, int ; res = CertNameToStrW(dwCertEncodingType, varptr(pName), dwStrType, varptr(psz), csz) ; dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "int" ; pName : CRYPT_INTEGER_BLOB* -> "intptr" ; dwStrType : CERT_STRING_TYPE -> "int" ; psz : LPWSTR optional, out -> "intptr" ; csz : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
procCertNameToStrW = crypt32.NewProc("CertNameToStrW")
)
// dwCertEncodingType (CERT_QUERY_ENCODING_TYPE), pName (CRYPT_INTEGER_BLOB*), dwStrType (CERT_STRING_TYPE), psz (LPWSTR optional, out), csz (DWORD)
r1, _, err := procCertNameToStrW.Call(
uintptr(dwCertEncodingType),
uintptr(pName),
uintptr(dwStrType),
uintptr(psz),
uintptr(csz),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // DWORDfunction CertNameToStrW(
dwCertEncodingType: DWORD; // CERT_QUERY_ENCODING_TYPE
pName: Pointer; // CRYPT_INTEGER_BLOB*
dwStrType: DWORD; // CERT_STRING_TYPE
psz: PWideChar; // LPWSTR optional, out
csz: DWORD // DWORD
): DWORD; stdcall;
external 'CRYPT32.dll' name 'CertNameToStrW';result := DllCall("CRYPT32\CertNameToStrW"
, "UInt", dwCertEncodingType ; CERT_QUERY_ENCODING_TYPE
, "Ptr", pName ; CRYPT_INTEGER_BLOB*
, "UInt", dwStrType ; CERT_STRING_TYPE
, "Ptr", psz ; LPWSTR optional, out
, "UInt", csz ; DWORD
, "UInt") ; return: DWORD●CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz) = DLL("CRYPT32.dll", "dword CertNameToStrW(dword, void*, dword, char*, dword)")
# 呼び出し: CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz)
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "dword"
# pName : CRYPT_INTEGER_BLOB* -> "void*"
# dwStrType : CERT_STRING_TYPE -> "dword"
# psz : LPWSTR optional, out -> "char*"
# csz : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。const std = @import("std");
extern "crypt32" fn CertNameToStrW(
dwCertEncodingType: u32, // CERT_QUERY_ENCODING_TYPE
pName: [*c]CRYPT_INTEGER_BLOB, // CRYPT_INTEGER_BLOB*
dwStrType: u32, // CERT_STRING_TYPE
psz: [*c]u16, // LPWSTR optional, out
csz: u32 // DWORD
) callconv(std.os.windows.WINAPI) u32;
// Unicode(-W): UTF-16LE のヌル終端バッファ([*c]const u16)を渡す。proc CertNameToStrW(
dwCertEncodingType: uint32, # CERT_QUERY_ENCODING_TYPE
pName: ptr CRYPT_INTEGER_BLOB, # CRYPT_INTEGER_BLOB*
dwStrType: uint32, # CERT_STRING_TYPE
psz: ptr uint16, # LPWSTR optional, out
csz: uint32 # DWORD
): uint32 {.importc: "CertNameToStrW", stdcall, dynlib: "CRYPT32.dll".}
# Unicode(-W): WideCString は newWideCString("...") で生成。pragma(lib, "crypt32");
extern(Windows)
uint CertNameToStrW(
uint dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
CRYPT_INTEGER_BLOB* pName, // CRYPT_INTEGER_BLOB*
uint dwStrType, // CERT_STRING_TYPE
wchar* psz, // LPWSTR optional, out
uint csz // DWORD
);ccall((:CertNameToStrW, "CRYPT32.dll"), stdcall, UInt32,
(UInt32, Ptr{CRYPT_INTEGER_BLOB}, UInt32, Ptr{UInt16}, UInt32),
dwCertEncodingType, pName, dwStrType, psz, csz)
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> UInt32
# pName : CRYPT_INTEGER_BLOB* -> Ptr{CRYPT_INTEGER_BLOB}
# dwStrType : CERT_STRING_TYPE -> UInt32
# psz : LPWSTR optional, out -> Ptr{UInt16}
# csz : DWORD -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
# Unicode(-W): Cwstring には transcode(UInt16, "...") 等で UTF-16 を渡す。local ffi = require("ffi")
ffi.cdef[[
uint32_t CertNameToStrW(
uint32_t dwCertEncodingType,
void* pName,
uint32_t dwStrType,
uint16_t* psz,
uint32_t csz);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz)
-- dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
-- pName : CRYPT_INTEGER_BLOB*
-- dwStrType : CERT_STRING_TYPE
-- psz : LPWSTR optional, out
-- csz : DWORD
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- Unicode(-W): uint16_t* には UTF-16LE のバッファ(ffi.new("uint16_t[?]", ...))を渡す。const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CertNameToStrW = lib.func('__stdcall', 'CertNameToStrW', 'uint32_t', ['uint32_t', 'void *', 'uint32_t', 'uint16_t *', 'uint32_t']);
// CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz)
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> 'uint32_t'
// pName : CRYPT_INTEGER_BLOB* -> 'void *'
// dwStrType : CERT_STRING_TYPE -> 'uint32_t'
// psz : LPWSTR optional, out -> 'uint16_t *'
// csz : DWORD -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("CRYPT32.dll", {
CertNameToStrW: { parameters: ["u32", "pointer", "u32", "buffer", "u32"], result: "u32" },
});
// lib.symbols.CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz)
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> "u32"
// pName : CRYPT_INTEGER_BLOB* -> "pointer"
// dwStrType : CERT_STRING_TYPE -> "u32"
// psz : LPWSTR optional, out -> "buffer"
// csz : DWORD -> "u32"
// 文字列は "buffer"。Unicode(-W) は new TextEncoder() ではなく UTF-16LE のバイト列(末尾に \x00\x00)を Uint8Array で渡す。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
uint32_t CertNameToStrW(
uint32_t dwCertEncodingType,
void* pName,
uint32_t dwStrType,
uint16_t* psz,
uint32_t csz);
C, "CRYPT32.dll");
// $ffi->CertNameToStrW(dwCertEncodingType, pName, dwStrType, psz, csz);
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE
// pName : CRYPT_INTEGER_BLOB*
// dwStrType : CERT_STRING_TYPE
// psz : LPWSTR optional, out
// csz : DWORD
// 構造体/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, W32APIOptions.UNICODE_OPTIONS);
int CertNameToStrW(
int dwCertEncodingType, // CERT_QUERY_ENCODING_TYPE
Pointer pName, // CRYPT_INTEGER_BLOB*
int dwStrType, // CERT_STRING_TYPE
char[] psz, // LPWSTR optional, out
int csz // DWORD
);
}
// Unicode(-W): WString(入力)/char[](出力)で UTF-16 をマーシャリング。@[Link("crypt32")]
lib LibCRYPT32
fun CertNameToStrW = CertNameToStrW(
dwCertEncodingType : UInt32, # CERT_QUERY_ENCODING_TYPE
pName : CRYPT_INTEGER_BLOB*, # CRYPT_INTEGER_BLOB*
dwStrType : UInt32, # CERT_STRING_TYPE
psz : UInt16*, # LPWSTR optional, out
csz : UInt32 # DWORD
) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef CertNameToStrWNative = Uint32 Function(Uint32, Pointer<Void>, Uint32, Pointer<Utf16>, Uint32);
typedef CertNameToStrWDart = int Function(int, Pointer<Void>, int, Pointer<Utf16>, int);
final CertNameToStrW = DynamicLibrary.open('CRYPT32.dll')
.lookupFunction<CertNameToStrWNative, CertNameToStrWDart>('CertNameToStrW');
// dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> Uint32
// pName : CRYPT_INTEGER_BLOB* -> Pointer<Void>
// dwStrType : CERT_STRING_TYPE -> Uint32
// psz : LPWSTR optional, out -> Pointer<Utf16>
// csz : DWORD -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function CertNameToStrW(
dwCertEncodingType: DWORD; // CERT_QUERY_ENCODING_TYPE
pName: Pointer; // CRYPT_INTEGER_BLOB*
dwStrType: DWORD; // CERT_STRING_TYPE
psz: PWideChar; // LPWSTR optional, out
csz: DWORD // DWORD
): DWORD; stdcall;
external 'CRYPT32.dll' name 'CertNameToStrW';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "CertNameToStrW"
c_CertNameToStrW :: Word32 -> Ptr () -> Word32 -> CWString -> Word32 -> IO Word32
-- dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> Word32
-- pName : CRYPT_INTEGER_BLOB* -> Ptr ()
-- dwStrType : CERT_STRING_TYPE -> Word32
-- psz : LPWSTR optional, out -> CWString
-- csz : DWORD -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let certnametostrw =
foreign "CertNameToStrW"
(uint32_t @-> (ptr void) @-> uint32_t @-> (ptr uint16_t) @-> uint32_t @-> returning uint32_t)
(* dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> uint32_t *)
(* pName : CRYPT_INTEGER_BLOB* -> (ptr void) *)
(* dwStrType : CERT_STRING_TYPE -> uint32_t *)
(* psz : LPWSTR optional, out -> (ptr uint16_t) *)
(* csz : DWORD -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)
(cffi:defcfun ("CertNameToStrW" cert-name-to-str-w :convention :stdcall) :uint32
(dw-cert-encoding-type :uint32) ; CERT_QUERY_ENCODING_TYPE
(p-name :pointer) ; CRYPT_INTEGER_BLOB*
(dw-str-type :uint32) ; CERT_STRING_TYPE
(psz :pointer) ; LPWSTR optional, out
(csz :uint32)) ; DWORD
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $CertNameToStrW = Win32::API::More->new('CRYPT32',
'DWORD CertNameToStrW(DWORD dwCertEncodingType, LPVOID pName, DWORD dwStrType, LPWSTR psz, DWORD csz)');
# my $ret = $CertNameToStrW->Call($dwCertEncodingType, $pName, $dwStrType, $psz, $csz);
# dwCertEncodingType : CERT_QUERY_ENCODING_TYPE -> DWORD
# pName : CRYPT_INTEGER_BLOB* -> LPVOID
# dwStrType : CERT_STRING_TYPE -> DWORD
# psz : LPWSTR optional, out -> LPWSTR
# csz : DWORD -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# Unicode(-W): LPCWSTR/LPWSTR は Win32::API が UTF-16 変換を行う。関連項目
- f CertNameToStrA (ANSI版) — エンコードされた証明書名をANSIのX.500文字列に変換する。
- f CertRDNValueToStrW — RDN属性値をUnicode文字列に変換する。
- f CertStrToNameW — UnicodeのX.500名文字列をエンコードされた証明書名に変換する。