ホーム › Networking.WinInet › INTERNET_CERTIFICATE_INFO
INTERNET_CERTIFICATE_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ftExpiry | FILETIME | 8 | +0 | +0 | 証明書の有効期限が切れる日付を格納する FILETIME 構造体です。 |
| ftStart | FILETIME | 8 | +8 | +8 | 証明書が有効になる日付を格納する FILETIME 構造体です。 |
| lpszSubjectInfo | CHAR* | 8/4 | +16 | +16 | 証明書の発行対象となった組織、サイト、およびサーバーの名前を格納するバッファーへのポインターです。アプリケーションは、このパラメーターに割り当てられたリソースを解放するために LocalFree を呼び出す必要があります。 |
| lpszIssuerInfo | CHAR* | 8/4 | +24 | +20 | 証明書を発行した組織、サイト、およびサーバーの名前を格納するバッファーへのポインターです。アプリケーションは、このパラメーターに割り当てられたリソースを解放するために LocalFree を呼び出す必要があります。 |
| lpszProtocolName | CHAR* | 8/4 | +32 | +24 | セキュリティで保護された接続を提供するために使用されるプロトコルの名前を格納するバッファーへのポインターです。アプリケーションは、このパラメーターに割り当てられたリソースを解放するために LocalFree を呼び出す必要があります。 |
| lpszSignatureAlgName | CHAR* | 8/4 | +40 | +28 | 証明書の署名に使用されるアルゴリズムの名前を格納するバッファーへのポインターです。アプリケーションは、このパラメーターに割り当てられたリソースを解放するために LocalFree を呼び出す必要があります。 |
| lpszEncryptionAlgName | CHAR* | 8/4 | +48 | +32 | セキュリティで保護されたチャネル (SSL/PCT) 接続上での暗号化に使用されるアルゴリズムの名前を格納するバッファーへのポインターです。アプリケーションは、このパラメーターに割り当てられたリソースを解放するために LocalFree を呼び出す必要があります。 |
| dwKeySize | DWORD | 4 | +56 | +36 | キーのサイズ (TCHAR 単位)。 |
公式ドキュメント
サーバーから返される証明書情報を格納します。この構造体は InternetQueryOption 関数で使用されます。
解説(Remarks)
ヘッダーの記述とは異なり、INTERNET_CERTIFICATE_INFO の実装は Unicode に対応していません。すべての文字列メンバーは、Unicode が有効かどうかにかかわらず ANSI 文字列として設定されます。そのため、これらの値を読み取る際、Unicode が有効な場合、呼び出し元はそれらを LPSTR にキャストする必要があります。
この情報を要求するアプリケーションは、割り当てられて返される構造体に設定されたポインターを解放する必要があります。
注意 WinINet はサーバー実装をサポートしていません。また、サービスから使用しないでください。サーバー実装やサービスでは、Microsoft Windows HTTP Services (WinHTTP) を使用してください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FILETIME (x64 8 / x86 8 バイト)
typedef struct FILETIME {
DWORD dwLowDateTime;
DWORD dwHighDateTime;
} FILETIME;
// INTERNET_CERTIFICATE_INFO (x64 64 / x86 40 バイト)
typedef struct INTERNET_CERTIFICATE_INFO {
FILETIME ftExpiry;
FILETIME ftStart;
CHAR* lpszSubjectInfo;
CHAR* lpszIssuerInfo;
CHAR* lpszProtocolName;
CHAR* lpszSignatureAlgName;
CHAR* lpszEncryptionAlgName;
DWORD dwKeySize;
} INTERNET_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 INTERNET_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 INTERNET_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 Structureimport ctypes
from ctypes import wintypes
class FILETIME(ctypes.Structure):
_fields_ = [
("dwLowDateTime", wintypes.DWORD),
("dwHighDateTime", wintypes.DWORD),
]
class INTERNET_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 INTERNET_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 INTERNET_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;
INTERNET_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 INTERNET_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
INTERNET_CERTIFICATE_INFO {.bycopy.} = object
ftExpiry: FILETIME
ftStart: FILETIME
lpszSubjectInfo: pointer
lpszIssuerInfo: pointer
lpszProtocolName: pointer
lpszSignatureAlgName: pointer
lpszEncryptionAlgName: pointer
dwKeySize: uint32struct FILETIME
{
uint dwLowDateTime;
uint dwHighDateTime;
}
struct INTERNET_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 レイアウト)
; INTERNET_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 : CHAR* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lpszIssuerInfo : CHAR* (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; lpszProtocolName : CHAR* (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; lpszSignatureAlgName : CHAR* (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; lpszEncryptionAlgName : CHAR* (+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 レイアウト)
; INTERNET_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 : CHAR* (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpszIssuerInfo : CHAR* (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpszProtocolName : CHAR* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpszSignatureAlgName : CHAR* (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpszEncryptionAlgName : CHAR* (+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 INTERNET_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, INTERNET_CERTIFICATE_INFO ; NSTRUCT 変数を確保
st->dwKeySize = 100
mes "dwKeySize=" + st->dwKeySize