Win32 API 日本語リファレンス
ホームNetworking.WinHttp › WINHTTP_CERTIFICATE_INFO

WINHTTP_CERTIFICATE_INFO

構造体
サイズx64: 64 バイト / x86: 40 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
ftExpiryFILETIME8+0+0サーバー証明書の有効期限日時(FILETIME)。
ftStartFILETIME8+8+8サーバー証明書の有効開始日時(FILETIME)。
lpszSubjectInfoLPWSTR8/4+16+16証明書のサブジェクト(発行先)情報文字列。NULL可。
lpszIssuerInfoLPWSTR8/4+24+20証明書の発行者情報文字列。NULL可。
lpszProtocolNameLPWSTR8/4+32+24接続に使用されたセキュリティプロトコル名文字列(TLS等)。
lpszSignatureAlgNameLPWSTR8/4+40+28証明書の署名アルゴリズム名文字列。
lpszEncryptionAlgNameLPWSTR8/4+48+32接続に使用された暗号化アルゴリズム名文字列。
dwKeySizeDWORD4+56+36暗号鍵のサイズ(ビット数)。

各言語での定義

#include <windows.h>

// FILETIME  (x64 8 / x86 8 バイト)
typedef struct FILETIME {
    DWORD dwLowDateTime;
    DWORD dwHighDateTime;
} FILETIME;

// WINHTTP_CERTIFICATE_INFO  (x64 64 / x86 40 バイト)
typedef struct WINHTTP_CERTIFICATE_INFO {
    FILETIME ftExpiry;
    FILETIME ftStart;
    LPWSTR lpszSubjectInfo;
    LPWSTR lpszIssuerInfo;
    LPWSTR lpszProtocolName;
    LPWSTR lpszSignatureAlgName;
    LPWSTR lpszEncryptionAlgName;
    DWORD dwKeySize;
} WINHTTP_CERTIFICATE_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FILETIME
{
    public uint dwLowDateTime;
    public uint dwHighDateTime;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WINHTTP_CERTIFICATE_INFO
{
    public FILETIME ftExpiry;
    public FILETIME ftStart;
    public IntPtr lpszSubjectInfo;
    public IntPtr lpszIssuerInfo;
    public IntPtr lpszProtocolName;
    public IntPtr lpszSignatureAlgName;
    public IntPtr lpszEncryptionAlgName;
    public uint dwKeySize;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FILETIME
    Public dwLowDateTime As UInteger
    Public dwHighDateTime As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WINHTTP_CERTIFICATE_INFO
    Public ftExpiry As FILETIME
    Public ftStart As FILETIME
    Public lpszSubjectInfo As IntPtr
    Public lpszIssuerInfo As IntPtr
    Public lpszProtocolName As IntPtr
    Public lpszSignatureAlgName As IntPtr
    Public lpszEncryptionAlgName As IntPtr
    Public dwKeySize As UInteger
End Structure
import ctypes
from ctypes import wintypes

class FILETIME(ctypes.Structure):
    _fields_ = [
        ("dwLowDateTime", wintypes.DWORD),
        ("dwHighDateTime", wintypes.DWORD),
    ]

class WINHTTP_CERTIFICATE_INFO(ctypes.Structure):
    _fields_ = [
        ("ftExpiry", FILETIME),
        ("ftStart", FILETIME),
        ("lpszSubjectInfo", ctypes.c_void_p),
        ("lpszIssuerInfo", ctypes.c_void_p),
        ("lpszProtocolName", ctypes.c_void_p),
        ("lpszSignatureAlgName", ctypes.c_void_p),
        ("lpszEncryptionAlgName", ctypes.c_void_p),
        ("dwKeySize", wintypes.DWORD),
    ]
#[repr(C)]
pub struct FILETIME {
    pub dwLowDateTime: u32,
    pub dwHighDateTime: u32,
}

#[repr(C)]
pub struct WINHTTP_CERTIFICATE_INFO {
    pub ftExpiry: FILETIME,
    pub ftStart: FILETIME,
    pub lpszSubjectInfo: *mut core::ffi::c_void,
    pub lpszIssuerInfo: *mut core::ffi::c_void,
    pub lpszProtocolName: *mut core::ffi::c_void,
    pub lpszSignatureAlgName: *mut core::ffi::c_void,
    pub lpszEncryptionAlgName: *mut core::ffi::c_void,
    pub dwKeySize: u32,
}
import "golang.org/x/sys/windows"

type FILETIME struct {
	dwLowDateTime uint32
	dwHighDateTime uint32
}

type WINHTTP_CERTIFICATE_INFO struct {
	ftExpiry FILETIME
	ftStart FILETIME
	lpszSubjectInfo uintptr
	lpszIssuerInfo uintptr
	lpszProtocolName uintptr
	lpszSignatureAlgName uintptr
	lpszEncryptionAlgName uintptr
	dwKeySize uint32
}
type
  FILETIME = record
    dwLowDateTime: DWORD;
    dwHighDateTime: DWORD;
  end;

  WINHTTP_CERTIFICATE_INFO = record
    ftExpiry: FILETIME;
    ftStart: FILETIME;
    lpszSubjectInfo: Pointer;
    lpszIssuerInfo: Pointer;
    lpszProtocolName: Pointer;
    lpszSignatureAlgName: Pointer;
    lpszEncryptionAlgName: Pointer;
    dwKeySize: DWORD;
  end;
const FILETIME = extern struct {
    dwLowDateTime: u32,
    dwHighDateTime: u32,
};

const WINHTTP_CERTIFICATE_INFO = extern struct {
    ftExpiry: FILETIME,
    ftStart: FILETIME,
    lpszSubjectInfo: ?*anyopaque,
    lpszIssuerInfo: ?*anyopaque,
    lpszProtocolName: ?*anyopaque,
    lpszSignatureAlgName: ?*anyopaque,
    lpszEncryptionAlgName: ?*anyopaque,
    dwKeySize: u32,
};
type
  FILETIME {.bycopy.} = object
    dwLowDateTime: uint32
    dwHighDateTime: uint32

  WINHTTP_CERTIFICATE_INFO {.bycopy.} = object
    ftExpiry: FILETIME
    ftStart: FILETIME
    lpszSubjectInfo: pointer
    lpszIssuerInfo: pointer
    lpszProtocolName: pointer
    lpszSignatureAlgName: pointer
    lpszEncryptionAlgName: pointer
    dwKeySize: uint32
struct FILETIME
{
    uint dwLowDateTime;
    uint dwHighDateTime;
}

struct WINHTTP_CERTIFICATE_INFO
{
    FILETIME ftExpiry;
    FILETIME ftStart;
    void* lpszSubjectInfo;
    void* lpszIssuerInfo;
    void* lpszProtocolName;
    void* lpszSignatureAlgName;
    void* lpszEncryptionAlgName;
    uint dwKeySize;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WINHTTP_CERTIFICATE_INFO サイズ: 40 バイト(x86)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; ftExpiry : FILETIME (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; ftStart : FILETIME (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; lpszSubjectInfo : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpszIssuerInfo : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpszProtocolName : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpszSignatureAlgName : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lpszEncryptionAlgName : LPWSTR (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwKeySize : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WINHTTP_CERTIFICATE_INFO サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; ftExpiry : FILETIME (+0, 8byte)  varptr(st)+0 を基点に操作(8byte:入れ子/配列)
; ftStart : FILETIME (+8, 8byte)  varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; lpszSubjectInfo : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpszIssuerInfo : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpszProtocolName : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpszSignatureAlgName : LPWSTR (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpszEncryptionAlgName : LPWSTR (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; dwKeySize : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global FILETIME
    #field int dwLowDateTime
    #field int dwHighDateTime
#endstruct

#defstruct global WINHTTP_CERTIFICATE_INFO
    #field FILETIME ftExpiry
    #field FILETIME ftStart
    #field intptr lpszSubjectInfo
    #field intptr lpszIssuerInfo
    #field intptr lpszProtocolName
    #field intptr lpszSignatureAlgName
    #field intptr lpszEncryptionAlgName
    #field int dwKeySize
#endstruct

stdim st, WINHTTP_CERTIFICATE_INFO        ; NSTRUCT 変数を確保
st->dwKeySize = 100
mes "dwKeySize=" + st->dwKeySize