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

HTTP_SERVER_AUTHENTICATION_INFO

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 64 バイト / x86: 36 バイト

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

フィールド

フィールド型サイズx64x86説明
FlagsHTTP_PROPERTY_FLAGS4+0+0プロパティの有効状態を示すHTTP_PROPERTY_FLAGSである。
AuthSchemesDWORD4+4+4有効にする認証方式を示すHTTP_AUTH_ENABLE_*フラグのビット集合である。
ReceiveMutualAuthBOOLEAN1+8+8相互認証情報を受け取るかを示すBOOLEAN値である。
ReceiveContextHandleBOOLEAN1+9+9認証コンテキストハンドルを受け取るかを示すBOOLEAN値である。
DisableNTLMCredentialCachingBOOLEAN1+10+10NTLM資格情報のキャッシュを無効にするかを示すBOOLEAN値である。
ExFlagsBYTE1+11+11拡張動作を制御するフラグ(BYTE)である。
DigestParamsHTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS32/16+16+12ダイジェスト認証用パラメータHTTP_SERVER_AUTHENTICATION_DIGEST_PARAMSである。
BasicParamsHTTP_SERVER_AUTHENTICATION_BASIC_PARAMS16/8+48+28Basic認証用パラメータHTTP_SERVER_AUTHENTICATION_BASIC_PARAMSである。

各言語での定義

#include <windows.h>

// HTTP_PROPERTY_FLAGS  (x64 4 / x86 4 バイト)
typedef struct HTTP_PROPERTY_FLAGS {
    DWORD _bitfield;
} HTTP_PROPERTY_FLAGS;

// HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS  (x64 32 / x86 16 バイト)
typedef struct HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS {
    WORD DomainNameLength;
    LPWSTR DomainName;
    WORD RealmLength;
    LPWSTR Realm;
} HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS;

// HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS  (x64 16 / x86 8 バイト)
typedef struct HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS {
    WORD RealmLength;
    LPWSTR Realm;
} HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS;

// HTTP_SERVER_AUTHENTICATION_INFO  (x64 64 / x86 36 バイト)
typedef struct HTTP_SERVER_AUTHENTICATION_INFO {
    HTTP_PROPERTY_FLAGS Flags;
    DWORD AuthSchemes;
    BOOLEAN ReceiveMutualAuth;
    BOOLEAN ReceiveContextHandle;
    BOOLEAN DisableNTLMCredentialCaching;
    BYTE ExFlags;
    HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
    HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams;
} HTTP_SERVER_AUTHENTICATION_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_PROPERTY_FLAGS
{
    public uint _bitfield;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
{
    public ushort DomainNameLength;
    public IntPtr DomainName;
    public ushort RealmLength;
    public IntPtr Realm;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
{
    public ushort RealmLength;
    public IntPtr Realm;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct HTTP_SERVER_AUTHENTICATION_INFO
{
    public HTTP_PROPERTY_FLAGS Flags;
    public uint AuthSchemes;
    [MarshalAs(UnmanagedType.U1)] public bool ReceiveMutualAuth;
    [MarshalAs(UnmanagedType.U1)] public bool ReceiveContextHandle;
    [MarshalAs(UnmanagedType.U1)] public bool DisableNTLMCredentialCaching;
    public byte ExFlags;
    public HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
    public HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_PROPERTY_FLAGS
    Public _bitfield As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
    Public DomainNameLength As UShort
    Public DomainName As IntPtr
    Public RealmLength As UShort
    Public Realm As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
    Public RealmLength As UShort
    Public Realm As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure HTTP_SERVER_AUTHENTICATION_INFO
    Public Flags As HTTP_PROPERTY_FLAGS
    Public AuthSchemes As UInteger
    <MarshalAs(UnmanagedType.U1)> Public ReceiveMutualAuth As Boolean
    <MarshalAs(UnmanagedType.U1)> Public ReceiveContextHandle As Boolean
    <MarshalAs(UnmanagedType.U1)> Public DisableNTLMCredentialCaching As Boolean
    Public ExFlags As Byte
    Public DigestParams As HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
    Public BasicParams As HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
End Structure
import ctypes
from ctypes import wintypes

class HTTP_PROPERTY_FLAGS(ctypes.Structure):
    _fields_ = [
        ("_bitfield", wintypes.DWORD),
    ]

class HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS(ctypes.Structure):
    _fields_ = [
        ("DomainNameLength", ctypes.c_ushort),
        ("DomainName", ctypes.c_void_p),
        ("RealmLength", ctypes.c_ushort),
        ("Realm", ctypes.c_void_p),
    ]

class HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS(ctypes.Structure):
    _fields_ = [
        ("RealmLength", ctypes.c_ushort),
        ("Realm", ctypes.c_void_p),
    ]

class HTTP_SERVER_AUTHENTICATION_INFO(ctypes.Structure):
    _fields_ = [
        ("Flags", HTTP_PROPERTY_FLAGS),
        ("AuthSchemes", wintypes.DWORD),
        ("ReceiveMutualAuth", ctypes.c_byte),
        ("ReceiveContextHandle", ctypes.c_byte),
        ("DisableNTLMCredentialCaching", ctypes.c_byte),
        ("ExFlags", ctypes.c_ubyte),
        ("DigestParams", HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS),
        ("BasicParams", HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS),
    ]
#[repr(C)]
pub struct HTTP_PROPERTY_FLAGS {
    pub _bitfield: u32,
}

#[repr(C)]
pub struct HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS {
    pub DomainNameLength: u16,
    pub DomainName: *mut core::ffi::c_void,
    pub RealmLength: u16,
    pub Realm: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS {
    pub RealmLength: u16,
    pub Realm: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct HTTP_SERVER_AUTHENTICATION_INFO {
    pub Flags: HTTP_PROPERTY_FLAGS,
    pub AuthSchemes: u32,
    pub ReceiveMutualAuth: u8,
    pub ReceiveContextHandle: u8,
    pub DisableNTLMCredentialCaching: u8,
    pub ExFlags: u8,
    pub DigestParams: HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS,
    pub BasicParams: HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS,
}
import "golang.org/x/sys/windows"

type HTTP_PROPERTY_FLAGS struct {
	_bitfield uint32
}

type HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS struct {
	DomainNameLength uint16
	DomainName uintptr
	RealmLength uint16
	Realm uintptr
}

type HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS struct {
	RealmLength uint16
	Realm uintptr
}

type HTTP_SERVER_AUTHENTICATION_INFO struct {
	Flags HTTP_PROPERTY_FLAGS
	AuthSchemes uint32
	ReceiveMutualAuth byte
	ReceiveContextHandle byte
	DisableNTLMCredentialCaching byte
	ExFlags byte
	DigestParams HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
	BasicParams HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
}
type
  HTTP_PROPERTY_FLAGS = record
    _bitfield: DWORD;
  end;

  HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS = record
    DomainNameLength: Word;
    DomainName: Pointer;
    RealmLength: Word;
    Realm: Pointer;
  end;

  HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS = record
    RealmLength: Word;
    Realm: Pointer;
  end;

  HTTP_SERVER_AUTHENTICATION_INFO = record
    Flags: HTTP_PROPERTY_FLAGS;
    AuthSchemes: DWORD;
    ReceiveMutualAuth: ByteBool;
    ReceiveContextHandle: ByteBool;
    DisableNTLMCredentialCaching: ByteBool;
    ExFlags: Byte;
    DigestParams: HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS;
    BasicParams: HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS;
  end;
const HTTP_PROPERTY_FLAGS = extern struct {
    _bitfield: u32,
};

const HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS = extern struct {
    DomainNameLength: u16,
    DomainName: ?*anyopaque,
    RealmLength: u16,
    Realm: ?*anyopaque,
};

const HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS = extern struct {
    RealmLength: u16,
    Realm: ?*anyopaque,
};

const HTTP_SERVER_AUTHENTICATION_INFO = extern struct {
    Flags: HTTP_PROPERTY_FLAGS,
    AuthSchemes: u32,
    ReceiveMutualAuth: u8,
    ReceiveContextHandle: u8,
    DisableNTLMCredentialCaching: u8,
    ExFlags: u8,
    DigestParams: HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS,
    BasicParams: HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS,
};
type
  HTTP_PROPERTY_FLAGS {.bycopy.} = object
    _bitfield: uint32

  HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS {.bycopy.} = object
    DomainNameLength: uint16
    DomainName: pointer
    RealmLength: uint16
    Realm: pointer

  HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS {.bycopy.} = object
    RealmLength: uint16
    Realm: pointer

  HTTP_SERVER_AUTHENTICATION_INFO {.bycopy.} = object
    Flags: HTTP_PROPERTY_FLAGS
    AuthSchemes: uint32
    ReceiveMutualAuth: uint8
    ReceiveContextHandle: uint8
    DisableNTLMCredentialCaching: uint8
    ExFlags: uint8
    DigestParams: HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
    BasicParams: HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
struct HTTP_PROPERTY_FLAGS
{
    uint _bitfield;
}

struct HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
{
    ushort DomainNameLength;
    void* DomainName;
    ushort RealmLength;
    void* Realm;
}

struct HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
{
    ushort RealmLength;
    void* Realm;
}

struct HTTP_SERVER_AUTHENTICATION_INFO
{
    HTTP_PROPERTY_FLAGS Flags;
    uint AuthSchemes;
    ubyte ReceiveMutualAuth;
    ubyte ReceiveContextHandle;
    ubyte DisableNTLMCredentialCaching;
    ubyte ExFlags;
    HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
    HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; HTTP_SERVER_AUTHENTICATION_INFO サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; Flags : HTTP_PROPERTY_FLAGS (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; AuthSchemes : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ReceiveMutualAuth : BOOLEAN (+8, 1byte)  poke st,8,値  /  値 = peek(st,8)
; ReceiveContextHandle : BOOLEAN (+9, 1byte)  poke st,9,値  /  値 = peek(st,9)
; DisableNTLMCredentialCaching : BOOLEAN (+10, 1byte)  poke st,10,値  /  値 = peek(st,10)
; ExFlags : BYTE (+11, 1byte)  poke st,11,値  /  値 = peek(st,11)
; DigestParams : HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS (+12, 16byte)  varptr(st)+12 を基点に操作(16byte:入れ子/配列)
; BasicParams : HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; HTTP_SERVER_AUTHENTICATION_INFO サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; Flags : HTTP_PROPERTY_FLAGS (+0, 4byte)  varptr(st)+0 を基点に操作(4byte:入れ子/配列)
; AuthSchemes : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ReceiveMutualAuth : BOOLEAN (+8, 1byte)  poke st,8,値  /  値 = peek(st,8)
; ReceiveContextHandle : BOOLEAN (+9, 1byte)  poke st,9,値  /  値 = peek(st,9)
; DisableNTLMCredentialCaching : BOOLEAN (+10, 1byte)  poke st,10,値  /  値 = peek(st,10)
; ExFlags : BYTE (+11, 1byte)  poke st,11,値  /  値 = peek(st,11)
; DigestParams : HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS (+16, 32byte)  varptr(st)+16 を基点に操作(32byte:入れ子/配列)
; BasicParams : HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS (+48, 16byte)  varptr(st)+48 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global HTTP_PROPERTY_FLAGS
    #field int _bitfield
#endstruct

#defstruct global HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS
    #field short DomainNameLength
    #field intptr DomainName
    #field short RealmLength
    #field intptr Realm
#endstruct

#defstruct global HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS
    #field short RealmLength
    #field intptr Realm
#endstruct

#defstruct global HTTP_SERVER_AUTHENTICATION_INFO
    #field HTTP_PROPERTY_FLAGS Flags
    #field int AuthSchemes
    #field bool1 ReceiveMutualAuth
    #field bool1 ReceiveContextHandle
    #field bool1 DisableNTLMCredentialCaching
    #field byte ExFlags
    #field HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams
    #field HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams
#endstruct

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