CERT_ACCESS_DESCRIPTION
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pszAccessMethod | LPSTR | 8/4 | +0 | +0 | アクセス方法の オブジェクト識別子 (OID) を指定します。 現在定義されている PKIX のアクセス方法 OID は次のとおりです。
|
| AccessLocation | CERT_ALT_NAME_ENTRY | 24/12 | +8 | +4 | 拡張を含む証明書について、現在の証明書の状態情報を取得するためのオンライン状態サーバーとアクセス プロトコルを記述する CERT_ALT_NAME_ENTRY 構造体です。 szOID_PKIX_OCSP アクセス方法の場合、AccessLocation は、この拡張を含む証明書の状態情報を取得するために必要なオンライン状態サーバーとアクセス プロトコルを記述します。 szOID_PKIX_CA_ISSUERS アクセス方法の場合、AccessLocation は、この拡張を含む証明書を発行した CA よりも上位の証明書を発行した CA に関する情報を取得します。この CA 発行者の記述は、証明書の利用者が信頼する地点で終わる証明書パスを選択できるように支援することを目的としています。 szOID_PKIX_CA_REPOSITORY 方式の場合、AccessLocation は、証明機関 (CA) であるサブジェクトについて、証明書および証明書失効リスト (CRL) のリポジトリの URI、ディレクトリ名、または電子メール アドレスを指定します。 |
公式ドキュメント
CERT_ACCESS_DESCRIPTION 構造体は、 CERT_AUTHORITY_INFO_ACCESS 構造体のメンバーです。この構造体は、subject information access 拡張または authority information access 拡張を含む証明書について、それぞれそのサブジェクトまたは発行者に関する情報やサービスにアクセスする方法を示す情報を 1 件保持します。これらの証明書拡張の詳細については、RFC 3280 を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CERT_ALT_NAME_ENTRY (x64 24 / x86 12 バイト)
typedef struct CERT_ALT_NAME_ENTRY {
DWORD dwAltNameChoice;
_Anonymous_e__Union Anonymous;
} CERT_ALT_NAME_ENTRY;
// CERT_ACCESS_DESCRIPTION (x64 32 / x86 16 バイト)
typedef struct CERT_ACCESS_DESCRIPTION {
LPSTR pszAccessMethod;
CERT_ALT_NAME_ENTRY AccessLocation;
} CERT_ACCESS_DESCRIPTION;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CERT_ALT_NAME_ENTRY
{
public uint dwAltNameChoice;
public _Anonymous_e__Union Anonymous;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CERT_ACCESS_DESCRIPTION
{
public IntPtr pszAccessMethod;
public CERT_ALT_NAME_ENTRY AccessLocation;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CERT_ALT_NAME_ENTRY
Public dwAltNameChoice As UInteger
Public Anonymous As _Anonymous_e__Union
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CERT_ACCESS_DESCRIPTION
Public pszAccessMethod As IntPtr
Public AccessLocation As CERT_ALT_NAME_ENTRY
End Structureimport ctypes
from ctypes import wintypes
class CERT_ALT_NAME_ENTRY(ctypes.Structure):
_fields_ = [
("dwAltNameChoice", wintypes.DWORD),
("Anonymous", _Anonymous_e__Union),
]
class CERT_ACCESS_DESCRIPTION(ctypes.Structure):
_fields_ = [
("pszAccessMethod", ctypes.c_void_p),
("AccessLocation", CERT_ALT_NAME_ENTRY),
]#[repr(C)]
pub struct CERT_ALT_NAME_ENTRY {
pub dwAltNameChoice: u32,
pub Anonymous: _Anonymous_e__Union,
}
#[repr(C)]
pub struct CERT_ACCESS_DESCRIPTION {
pub pszAccessMethod: *mut core::ffi::c_void,
pub AccessLocation: CERT_ALT_NAME_ENTRY,
}import "golang.org/x/sys/windows"
type CERT_ALT_NAME_ENTRY struct {
dwAltNameChoice uint32
Anonymous _Anonymous_e__Union
}
type CERT_ACCESS_DESCRIPTION struct {
pszAccessMethod uintptr
AccessLocation CERT_ALT_NAME_ENTRY
}type
CERT_ALT_NAME_ENTRY = record
dwAltNameChoice: DWORD;
Anonymous: _Anonymous_e__Union;
end;
CERT_ACCESS_DESCRIPTION = record
pszAccessMethod: Pointer;
AccessLocation: CERT_ALT_NAME_ENTRY;
end;const CERT_ALT_NAME_ENTRY = extern struct {
dwAltNameChoice: u32,
Anonymous: _Anonymous_e__Union,
};
const CERT_ACCESS_DESCRIPTION = extern struct {
pszAccessMethod: ?*anyopaque,
AccessLocation: CERT_ALT_NAME_ENTRY,
};type
CERT_ALT_NAME_ENTRY {.bycopy.} = object
dwAltNameChoice: uint32
Anonymous: _Anonymous_e__Union
CERT_ACCESS_DESCRIPTION {.bycopy.} = object
pszAccessMethod: pointer
AccessLocation: CERT_ALT_NAME_ENTRYstruct CERT_ALT_NAME_ENTRY
{
uint dwAltNameChoice;
_Anonymous_e__Union Anonymous;
}
struct CERT_ACCESS_DESCRIPTION
{
void* pszAccessMethod;
CERT_ALT_NAME_ENTRY AccessLocation;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CERT_ACCESS_DESCRIPTION サイズ: 16 バイト(x86)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; pszAccessMethod : LPSTR (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; AccessLocation : CERT_ALT_NAME_ENTRY (+4, 12byte) varptr(st)+4 を基点に操作(12byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CERT_ACCESS_DESCRIPTION サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; pszAccessMethod : LPSTR (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; AccessLocation : CERT_ALT_NAME_ENTRY (+8, 24byte) varptr(st)+8 を基点に操作(24byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global CERT_ALT_NAME_ENTRY
#field int dwAltNameChoice
#field byte Anonymous 16
#endstruct
#defstruct global CERT_ACCESS_DESCRIPTION
#field intptr pszAccessMethod
#field CERT_ALT_NAME_ENTRY AccessLocation
#endstruct
stdim st, CERT_ACCESS_DESCRIPTION ; NSTRUCT 変数を確保