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

DSROLE_PRIMARY_DOMAIN_INFO_BASIC

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

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

フィールド

フィールド型サイズx64x86説明
MachineRoleDSROLE_MACHINE_ROLE4+0+0コンピューターの役割を指定する DSROLE_MACHINE_ROLE 値のいずれかを格納します。
FlagsDWORD4+4+4

ドメインに関する追加データを提供するフラグのセットを格納します。次の値のうち 1 つ以上の組み合わせを指定できます。

DSROLE_PRIMARY_DOMAIN_GUID_PRESENT

DomainGuid メンバーに有効なドメインの GUID が格納されています。

DSROLE_PRIMARY_DS_MIXED_MODE

ディレクトリ サービスは混在モードで動作しています。このフラグは、DSROLE_PRIMARY_DS_RUNNING フラグが設定されている場合にのみ有効です。

DSROLE_PRIMARY_DS_RUNNING

このコンピューターでディレクトリ サービスが動作しています。

DSROLE_PRIMARY_DS_READONLY

このコンピューターでディレクトリ サービスが読み取り専用として動作しています。

DSROLE_UPGRADE_IN_PROGRESS

このコンピューターは、以前のバージョンの Windows NT/Windows 2000 からアップグレード中です。

DomainNameFlatLPWSTR8/4+8+8NetBIOS ドメイン名を格納する、null で終わる Unicode 文字列へのポインターです。
DomainNameDnsLPWSTR8/4+16+12DNS ドメイン名を格納する、null で終わる Unicode 文字列へのポインターです。このメンバーは省略可能であり、NULL の場合があります。
DomainForestNameLPWSTR8/4+24+16フォレスト名を格納する、null で終わる Unicode 文字列へのポインターです。このメンバーは省略可能であり、NULL の場合があります。
DomainGuidGUID16+32+20ドメイン識別子を格納します。このメンバーは、Flags メンバーに DSROLE_PRIMARY_DOMAIN_GUID_PRESENT フラグが含まれている場合にのみ有効です。

公式ドキュメント

DSROLE_PRIMARY_DOMAIN_INFO_BASIC 構造体は、DsRoleGetPrimaryDomainInformation 関数で使用され、ドメインのデータを格納します。

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

各言語での定義

#include <windows.h>

// DSROLE_PRIMARY_DOMAIN_INFO_BASIC  (x64 48 / x86 36 バイト)
typedef struct DSROLE_PRIMARY_DOMAIN_INFO_BASIC {
    DSROLE_MACHINE_ROLE MachineRole;
    DWORD Flags;
    LPWSTR DomainNameFlat;
    LPWSTR DomainNameDns;
    LPWSTR DomainForestName;
    GUID DomainGuid;
} DSROLE_PRIMARY_DOMAIN_INFO_BASIC;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSROLE_PRIMARY_DOMAIN_INFO_BASIC
{
    public int MachineRole;
    public uint Flags;
    public IntPtr DomainNameFlat;
    public IntPtr DomainNameDns;
    public IntPtr DomainForestName;
    public Guid DomainGuid;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSROLE_PRIMARY_DOMAIN_INFO_BASIC
    Public MachineRole As Integer
    Public Flags As UInteger
    Public DomainNameFlat As IntPtr
    Public DomainNameDns As IntPtr
    Public DomainForestName As IntPtr
    Public DomainGuid As Guid
End Structure
import ctypes
from ctypes import wintypes

class DSROLE_PRIMARY_DOMAIN_INFO_BASIC(ctypes.Structure):
    _fields_ = [
        ("MachineRole", ctypes.c_int),
        ("Flags", wintypes.DWORD),
        ("DomainNameFlat", ctypes.c_void_p),
        ("DomainNameDns", ctypes.c_void_p),
        ("DomainForestName", ctypes.c_void_p),
        ("DomainGuid", GUID),
    ]
#[repr(C)]
pub struct DSROLE_PRIMARY_DOMAIN_INFO_BASIC {
    pub MachineRole: i32,
    pub Flags: u32,
    pub DomainNameFlat: *mut core::ffi::c_void,
    pub DomainNameDns: *mut core::ffi::c_void,
    pub DomainForestName: *mut core::ffi::c_void,
    pub DomainGuid: GUID,
}
import "golang.org/x/sys/windows"

type DSROLE_PRIMARY_DOMAIN_INFO_BASIC struct {
	MachineRole int32
	Flags uint32
	DomainNameFlat uintptr
	DomainNameDns uintptr
	DomainForestName uintptr
	DomainGuid windows.GUID
}
type
  DSROLE_PRIMARY_DOMAIN_INFO_BASIC = record
    MachineRole: Integer;
    Flags: DWORD;
    DomainNameFlat: Pointer;
    DomainNameDns: Pointer;
    DomainForestName: Pointer;
    DomainGuid: TGUID;
  end;
const DSROLE_PRIMARY_DOMAIN_INFO_BASIC = extern struct {
    MachineRole: i32,
    Flags: u32,
    DomainNameFlat: ?*anyopaque,
    DomainNameDns: ?*anyopaque,
    DomainForestName: ?*anyopaque,
    DomainGuid: GUID,
};
type
  DSROLE_PRIMARY_DOMAIN_INFO_BASIC {.bycopy.} = object
    MachineRole: int32
    Flags: uint32
    DomainNameFlat: pointer
    DomainNameDns: pointer
    DomainForestName: pointer
    DomainGuid: GUID
struct DSROLE_PRIMARY_DOMAIN_INFO_BASIC
{
    int MachineRole;
    uint Flags;
    void* DomainNameFlat;
    void* DomainNameDns;
    void* DomainForestName;
    GUID DomainGuid;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DSROLE_PRIMARY_DOMAIN_INFO_BASIC サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; MachineRole : DSROLE_MACHINE_ROLE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DomainNameFlat : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DomainNameDns : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; DomainForestName : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; DomainGuid : GUID (+20, 16byte)  varptr(st)+20 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DSROLE_PRIMARY_DOMAIN_INFO_BASIC サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; MachineRole : DSROLE_MACHINE_ROLE (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Flags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; DomainNameFlat : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; DomainNameDns : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; DomainForestName : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; DomainGuid : GUID (+32, 16byte)  varptr(st)+32 を基点に操作(16byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global DSROLE_PRIMARY_DOMAIN_INFO_BASIC
    #field int MachineRole
    #field int Flags
    #field intptr DomainNameFlat
    #field intptr DomainNameDns
    #field intptr DomainForestName
    #field GUID DomainGuid
#endstruct

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