Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › KERB_ADD_CREDENTIALS_REQUEST_EX

KERB_ADD_CREDENTIALS_REQUEST_EX

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

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

フィールド

フィールド型サイズx64x86説明
CredentialsKERB_ADD_CREDENTIALS_REQUEST72/40+0+0基本となる資格情報追加要求を保持するKERB_ADD_CREDENTIALS_REQUEST。
PrincipalNameCountDWORD4+72+40PrincipalNamesが指すプリンシパル名配列の要素数。
PrincipalNamesLSA_UNICODE_STRING16/8+80+44資格情報を関連付けるプリンシパル名の可変長配列の先頭要素。

各言語での定義

#include <windows.h>

// LSA_UNICODE_STRING  (x64 16 / x86 8 バイト)
typedef struct LSA_UNICODE_STRING {
    WORD Length;
    WORD MaximumLength;
    LPWSTR Buffer;
} LSA_UNICODE_STRING;

// LUID  (x64 8 / x86 8 バイト)
typedef struct LUID {
    DWORD LowPart;
    INT HighPart;
} LUID;

// KERB_ADD_CREDENTIALS_REQUEST  (x64 72 / x86 40 バイト)
typedef struct KERB_ADD_CREDENTIALS_REQUEST {
    KERB_PROTOCOL_MESSAGE_TYPE MessageType;
    LSA_UNICODE_STRING UserName;
    LSA_UNICODE_STRING DomainName;
    LSA_UNICODE_STRING Password;
    LUID LogonId;
    KERB_REQUEST_FLAGS Flags;
} KERB_ADD_CREDENTIALS_REQUEST;

// KERB_ADD_CREDENTIALS_REQUEST_EX  (x64 96 / x86 52 バイト)
typedef struct KERB_ADD_CREDENTIALS_REQUEST_EX {
    KERB_ADD_CREDENTIALS_REQUEST Credentials;
    DWORD PrincipalNameCount;
    LSA_UNICODE_STRING PrincipalNames[1];
} KERB_ADD_CREDENTIALS_REQUEST_EX;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LSA_UNICODE_STRING
{
    public ushort Length;
    public ushort MaximumLength;
    public IntPtr Buffer;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LUID
{
    public uint LowPart;
    public int HighPart;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KERB_ADD_CREDENTIALS_REQUEST
{
    public int MessageType;
    public LSA_UNICODE_STRING UserName;
    public LSA_UNICODE_STRING DomainName;
    public LSA_UNICODE_STRING Password;
    public LUID LogonId;
    public uint Flags;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KERB_ADD_CREDENTIALS_REQUEST_EX
{
    public KERB_ADD_CREDENTIALS_REQUEST Credentials;
    public uint PrincipalNameCount;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public LSA_UNICODE_STRING[] PrincipalNames;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LSA_UNICODE_STRING
    Public Length As UShort
    Public MaximumLength As UShort
    Public Buffer As IntPtr
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LUID
    Public LowPart As UInteger
    Public HighPart As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KERB_ADD_CREDENTIALS_REQUEST
    Public MessageType As Integer
    Public UserName As LSA_UNICODE_STRING
    Public DomainName As LSA_UNICODE_STRING
    Public Password As LSA_UNICODE_STRING
    Public LogonId As LUID
    Public Flags As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KERB_ADD_CREDENTIALS_REQUEST_EX
    Public Credentials As KERB_ADD_CREDENTIALS_REQUEST
    Public PrincipalNameCount As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public PrincipalNames() As LSA_UNICODE_STRING
End Structure
import ctypes
from ctypes import wintypes

class LSA_UNICODE_STRING(ctypes.Structure):
    _fields_ = [
        ("Length", ctypes.c_ushort),
        ("MaximumLength", ctypes.c_ushort),
        ("Buffer", ctypes.c_void_p),
    ]

class LUID(ctypes.Structure):
    _fields_ = [
        ("LowPart", wintypes.DWORD),
        ("HighPart", ctypes.c_int),
    ]

class KERB_ADD_CREDENTIALS_REQUEST(ctypes.Structure):
    _fields_ = [
        ("MessageType", ctypes.c_int),
        ("UserName", LSA_UNICODE_STRING),
        ("DomainName", LSA_UNICODE_STRING),
        ("Password", LSA_UNICODE_STRING),
        ("LogonId", LUID),
        ("Flags", wintypes.DWORD),
    ]

class KERB_ADD_CREDENTIALS_REQUEST_EX(ctypes.Structure):
    _fields_ = [
        ("Credentials", KERB_ADD_CREDENTIALS_REQUEST),
        ("PrincipalNameCount", wintypes.DWORD),
        ("PrincipalNames", LSA_UNICODE_STRING * 1),
    ]
#[repr(C)]
pub struct LSA_UNICODE_STRING {
    pub Length: u16,
    pub MaximumLength: u16,
    pub Buffer: *mut core::ffi::c_void,
}

#[repr(C)]
pub struct LUID {
    pub LowPart: u32,
    pub HighPart: i32,
}

#[repr(C)]
pub struct KERB_ADD_CREDENTIALS_REQUEST {
    pub MessageType: i32,
    pub UserName: LSA_UNICODE_STRING,
    pub DomainName: LSA_UNICODE_STRING,
    pub Password: LSA_UNICODE_STRING,
    pub LogonId: LUID,
    pub Flags: u32,
}

#[repr(C)]
pub struct KERB_ADD_CREDENTIALS_REQUEST_EX {
    pub Credentials: KERB_ADD_CREDENTIALS_REQUEST,
    pub PrincipalNameCount: u32,
    pub PrincipalNames: [LSA_UNICODE_STRING; 1],
}
import "golang.org/x/sys/windows"

type LSA_UNICODE_STRING struct {
	Length uint16
	MaximumLength uint16
	Buffer uintptr
}

type LUID struct {
	LowPart uint32
	HighPart int32
}

type KERB_ADD_CREDENTIALS_REQUEST struct {
	MessageType int32
	UserName LSA_UNICODE_STRING
	DomainName LSA_UNICODE_STRING
	Password LSA_UNICODE_STRING
	LogonId LUID
	Flags uint32
}

type KERB_ADD_CREDENTIALS_REQUEST_EX struct {
	Credentials KERB_ADD_CREDENTIALS_REQUEST
	PrincipalNameCount uint32
	PrincipalNames [1]LSA_UNICODE_STRING
}
type
  LSA_UNICODE_STRING = record
    Length: Word;
    MaximumLength: Word;
    Buffer: Pointer;
  end;

  LUID = record
    LowPart: DWORD;
    HighPart: Integer;
  end;

  KERB_ADD_CREDENTIALS_REQUEST = record
    MessageType: Integer;
    UserName: LSA_UNICODE_STRING;
    DomainName: LSA_UNICODE_STRING;
    Password: LSA_UNICODE_STRING;
    LogonId: LUID;
    Flags: DWORD;
  end;

  KERB_ADD_CREDENTIALS_REQUEST_EX = record
    Credentials: KERB_ADD_CREDENTIALS_REQUEST;
    PrincipalNameCount: DWORD;
    PrincipalNames: array[0..0] of LSA_UNICODE_STRING;
  end;
const LSA_UNICODE_STRING = extern struct {
    Length: u16,
    MaximumLength: u16,
    Buffer: ?*anyopaque,
};

const LUID = extern struct {
    LowPart: u32,
    HighPart: i32,
};

const KERB_ADD_CREDENTIALS_REQUEST = extern struct {
    MessageType: i32,
    UserName: LSA_UNICODE_STRING,
    DomainName: LSA_UNICODE_STRING,
    Password: LSA_UNICODE_STRING,
    LogonId: LUID,
    Flags: u32,
};

const KERB_ADD_CREDENTIALS_REQUEST_EX = extern struct {
    Credentials: KERB_ADD_CREDENTIALS_REQUEST,
    PrincipalNameCount: u32,
    PrincipalNames: [1]LSA_UNICODE_STRING,
};
type
  LSA_UNICODE_STRING {.bycopy.} = object
    Length: uint16
    MaximumLength: uint16
    Buffer: pointer

  LUID {.bycopy.} = object
    LowPart: uint32
    HighPart: int32

  KERB_ADD_CREDENTIALS_REQUEST {.bycopy.} = object
    MessageType: int32
    UserName: LSA_UNICODE_STRING
    DomainName: LSA_UNICODE_STRING
    Password: LSA_UNICODE_STRING
    LogonId: LUID
    Flags: uint32

  KERB_ADD_CREDENTIALS_REQUEST_EX {.bycopy.} = object
    Credentials: KERB_ADD_CREDENTIALS_REQUEST
    PrincipalNameCount: uint32
    PrincipalNames: array[1, LSA_UNICODE_STRING]
struct LSA_UNICODE_STRING
{
    ushort Length;
    ushort MaximumLength;
    void* Buffer;
}

struct LUID
{
    uint LowPart;
    int HighPart;
}

struct KERB_ADD_CREDENTIALS_REQUEST
{
    int MessageType;
    LSA_UNICODE_STRING UserName;
    LSA_UNICODE_STRING DomainName;
    LSA_UNICODE_STRING Password;
    LUID LogonId;
    uint Flags;
}

struct KERB_ADD_CREDENTIALS_REQUEST_EX
{
    KERB_ADD_CREDENTIALS_REQUEST Credentials;
    uint PrincipalNameCount;
    LSA_UNICODE_STRING[1] PrincipalNames;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; KERB_ADD_CREDENTIALS_REQUEST_EX サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; Credentials : KERB_ADD_CREDENTIALS_REQUEST (+0, 40byte)  varptr(st)+0 を基点に操作(40byte:入れ子/配列)
; PrincipalNameCount : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; PrincipalNames : LSA_UNICODE_STRING (+44, 8byte)  varptr(st)+44 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KERB_ADD_CREDENTIALS_REQUEST_EX サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; Credentials : KERB_ADD_CREDENTIALS_REQUEST (+0, 72byte)  varptr(st)+0 を基点に操作(72byte:入れ子/配列)
; PrincipalNameCount : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; PrincipalNames : LSA_UNICODE_STRING (+80, 16byte)  varptr(st)+80 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global LSA_UNICODE_STRING
    #field short Length
    #field short MaximumLength
    #field intptr Buffer
#endstruct

#defstruct global LUID
    #field int LowPart
    #field int HighPart
#endstruct

#defstruct global KERB_ADD_CREDENTIALS_REQUEST
    #field int MessageType
    #field LSA_UNICODE_STRING UserName
    #field LSA_UNICODE_STRING DomainName
    #field LSA_UNICODE_STRING Password
    #field LUID LogonId
    #field int Flags
#endstruct

#defstruct global KERB_ADD_CREDENTIALS_REQUEST_EX
    #field KERB_ADD_CREDENTIALS_REQUEST Credentials
    #field int PrincipalNameCount
    #field LSA_UNICODE_STRING PrincipalNames 1
#endstruct

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