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

SEC_WINNT_AUTH_IDENTITY_EXA

構造体
サイズx64: 72 バイト / x86: 44 バイト

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

フィールド

フィールドサイズx64x86説明
VersionDWORD4+0+0構造体のバージョン番号を示す unsigned long 値です。
LengthDWORD4+4+4構造体の長さをバイト単位で示す unsigned long 値です。
UserBYTE*8/4+8+8ユーザーアカウントの名前を格納する Unicode または ANSI 文字列です。
UserLengthDWORD4+16+12User 文字列の長さ (文字数) です。
DomainBYTE*8/4+24+16ユーザーアカウントのドメイン名を格納する Unicode または ANSI 文字列です。
DomainLengthDWORD4+32+20Domain 文字列の長さ (文字数) です。
PasswordBYTE*8/4+40+24ユーザーのパスワードをプレーンテキストで格納する Unicode または ANSI 文字列です。パスワードの使用が終わったら、SecureZeroMemory 関数を呼び出して、機密情報をメモリから消去してください。パスワードの保護の詳細については、Handling Passwords を参照してください。
PasswordLengthDWORD4+48+28Password 文字列の長さ (文字数) です。
FlagsDWORD4+52+32

ネゴシエーション可能な セキュリティパッケージ が使用する型を示す unsigned long 型のフラグです。

意味
SEC_WINNT_AUTH_IDENTITY_MARSHALLED
すべてのデータが 1 つのバッファーに格納されています。
SEC_WINNT_AUTH_IDENTITY_ONLY
Kerberos セキュリティサポートプロバイダー (SSP) と共に使用します。資格情報は識別 (identity) のみを目的としたものです。Kerberos パッケージは、チケットに承認データを含めないよう指示されます。
SEC_WINNT_AUTH_IDENTITY_ANSI
資格情報は ANSI 形式です。
SEC_WINNT_AUTH_IDENTITY_UNICODE
資格情報は Unicode 形式です。
PackageListBYTE*8/4+56+36

Microsoft Negotiate プロバイダーの使用時に利用できるセキュリティパッケージの名前を、コンマ区切りで列挙した Unicode または ANSI 文字列です。

NTLM パッケージを使用しないことを指定するには、これを "!ntlm" に設定します。

PackageListLengthDWORD4+64+40PackageList 文字列の長さ (文字数) です。

公式ドキュメント

SEC_WINNT_AUTH_IDENTITY_EX 構造体は、ユーザーに関する情報を格納します。この構造体には ANSI 形式と Unicode 形式の両方が用意されています。

解説(Remarks)

この構造体を RPC と共に使用する場合、構造体はバインディングハンドルの有効期間中ずっと有効なままでなければならないことに注意してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SEC_WINNT_AUTH_IDENTITY_EXA  (x64 72 / x86 44 バイト)
typedef struct SEC_WINNT_AUTH_IDENTITY_EXA {
    DWORD Version;
    DWORD Length;
    BYTE* User;
    DWORD UserLength;
    BYTE* Domain;
    DWORD DomainLength;
    BYTE* Password;
    DWORD PasswordLength;
    DWORD Flags;
    BYTE* PackageList;
    DWORD PackageListLength;
} SEC_WINNT_AUTH_IDENTITY_EXA;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SEC_WINNT_AUTH_IDENTITY_EXA
{
    public uint Version;
    public uint Length;
    public IntPtr User;
    public uint UserLength;
    public IntPtr Domain;
    public uint DomainLength;
    public IntPtr Password;
    public uint PasswordLength;
    public uint Flags;
    public IntPtr PackageList;
    public uint PackageListLength;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SEC_WINNT_AUTH_IDENTITY_EXA
    Public Version As UInteger
    Public Length As UInteger
    Public User As IntPtr
    Public UserLength As UInteger
    Public Domain As IntPtr
    Public DomainLength As UInteger
    Public Password As IntPtr
    Public PasswordLength As UInteger
    Public Flags As UInteger
    Public PackageList As IntPtr
    Public PackageListLength As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SEC_WINNT_AUTH_IDENTITY_EXA(ctypes.Structure):
    _fields_ = [
        ("Version", wintypes.DWORD),
        ("Length", wintypes.DWORD),
        ("User", ctypes.c_void_p),
        ("UserLength", wintypes.DWORD),
        ("Domain", ctypes.c_void_p),
        ("DomainLength", wintypes.DWORD),
        ("Password", ctypes.c_void_p),
        ("PasswordLength", wintypes.DWORD),
        ("Flags", wintypes.DWORD),
        ("PackageList", ctypes.c_void_p),
        ("PackageListLength", wintypes.DWORD),
    ]
#[repr(C)]
pub struct SEC_WINNT_AUTH_IDENTITY_EXA {
    pub Version: u32,
    pub Length: u32,
    pub User: *mut core::ffi::c_void,
    pub UserLength: u32,
    pub Domain: *mut core::ffi::c_void,
    pub DomainLength: u32,
    pub Password: *mut core::ffi::c_void,
    pub PasswordLength: u32,
    pub Flags: u32,
    pub PackageList: *mut core::ffi::c_void,
    pub PackageListLength: u32,
}
import "golang.org/x/sys/windows"

type SEC_WINNT_AUTH_IDENTITY_EXA struct {
	Version uint32
	Length uint32
	User uintptr
	UserLength uint32
	Domain uintptr
	DomainLength uint32
	Password uintptr
	PasswordLength uint32
	Flags uint32
	PackageList uintptr
	PackageListLength uint32
}
type
  SEC_WINNT_AUTH_IDENTITY_EXA = record
    Version: DWORD;
    Length: DWORD;
    User: Pointer;
    UserLength: DWORD;
    Domain: Pointer;
    DomainLength: DWORD;
    Password: Pointer;
    PasswordLength: DWORD;
    Flags: DWORD;
    PackageList: Pointer;
    PackageListLength: DWORD;
  end;
const SEC_WINNT_AUTH_IDENTITY_EXA = extern struct {
    Version: u32,
    Length: u32,
    User: ?*anyopaque,
    UserLength: u32,
    Domain: ?*anyopaque,
    DomainLength: u32,
    Password: ?*anyopaque,
    PasswordLength: u32,
    Flags: u32,
    PackageList: ?*anyopaque,
    PackageListLength: u32,
};
type
  SEC_WINNT_AUTH_IDENTITY_EXA {.bycopy.} = object
    Version: uint32
    Length: uint32
    User: pointer
    UserLength: uint32
    Domain: pointer
    DomainLength: uint32
    Password: pointer
    PasswordLength: uint32
    Flags: uint32
    PackageList: pointer
    PackageListLength: uint32
struct SEC_WINNT_AUTH_IDENTITY_EXA
{
    uint Version;
    uint Length;
    void* User;
    uint UserLength;
    void* Domain;
    uint DomainLength;
    void* Password;
    uint PasswordLength;
    uint Flags;
    void* PackageList;
    uint PackageListLength;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SEC_WINNT_AUTH_IDENTITY_EXA サイズ: 44 バイト(x86)
dim st, 11    ; 4byte整数×11(構造体サイズ 44 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Length : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; User : BYTE* (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; UserLength : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; Domain : BYTE* (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DomainLength : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; Password : BYTE* (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; PasswordLength : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; Flags : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; PackageList : BYTE* (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; PackageListLength : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SEC_WINNT_AUTH_IDENTITY_EXA サイズ: 72 バイト(x64)
dim st, 18    ; 4byte整数×18(構造体サイズ 72 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Length : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; User : BYTE* (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; UserLength : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; Domain : BYTE* (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; DomainLength : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; Password : BYTE* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; PasswordLength : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; Flags : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; PackageList : BYTE* (+56, 8byte)  qpoke st,56,値 / qpeek(st,56)  ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; PackageListLength : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SEC_WINNT_AUTH_IDENTITY_EXA
    #field int Version
    #field int Length
    #field intptr User
    #field int UserLength
    #field intptr Domain
    #field int DomainLength
    #field intptr Password
    #field int PasswordLength
    #field int Flags
    #field intptr PackageList
    #field int PackageListLength
#endstruct

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