DSOP_SCOPE_INIT_INFO
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| cbSize | DWORD | 4 | +0 | +0 | 構造体のサイズをバイト単位で格納します。 |
| flType | DWORD | 4 | +4 | +4 | この構造体が記述するスコープ型を示すフラグです。指定するすべてのスコープが同じ設定を使用する場合は、複数のスコープ型を組み合わせることができます。このメンバーには、次のフラグの組み合わせを指定できます。 DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)DSOP_INIT_INFO 構造体の pwzTargetComputer メンバーで指定されたコンピューターです。 対象のコンピューターがアップレベルまたはダウンレベルのドメイン コントローラーである場合、DSOP_INIT_INFO 構造体の flOptions メンバーに DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK フラグが設定されていない限り、このフラグは無視されます。 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)対象のコンピューターが参加しているアップレベル ドメインです。このフラグを設定する場合は、pwzDcName メンバーで参加先ドメインのドメイン コントローラーの名前を指定します。 DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)対象のコンピューターが参加しているダウンレベル ドメインです。 DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)対象のコンピューターが属するエンタープライズ内のすべてのドメインです。DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN スコープが指定されている場合、DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN スコープは、参加先ドメインを除くエンタープライズ内のすべてのドメインを表します。 DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)エンタープライズ内のすべてのドメインのオブジェクトを含むスコープです。エンタープライズにはアップレベル ドメインのみを含めることができます。 DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)エンタープライズの外部にあり、対象のコンピューターが参加しているドメインから信頼されている、すべてのアップレベル ドメインです。 DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)エンタープライズの外部にあり、対象のコンピューターが参加しているドメインから信頼されている、すべてのダウンレベル ドメインです。 DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)対象のコンピューターが参加しているワークグループです。対象のコンピューターがドメインに参加していない場合にのみ適用されます。 ワークグループから選択できるオブジェクトの種類はコンピューターのみです。 DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)ユーザーがアップレベル スコープを入力できるようにします。DSOP_SCOPE_TYPE_USER_ENTERED_* の型がいずれも指定されていない場合、ダイアログ ボックスは Look in ドロップダウン リストにあるスコープのみをユーザーが選択できるように制限します。 DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)ユーザーがダウンレベル スコープを入力できるようにします。 |
| flScope | DWORD | 4 | +8 | +8 | このスコープから選択されたオブジェクトの ADsPath を返す際に使用する形式を示すフラグです。flScope メンバーでは、Look in ドロップダウン リストに最初に表示されるスコープを示すこともできます。このメンバーには、次のフラグの組み合わせを指定できます。 LDAP およびグローバル カタログ (GC) のパスは、WinNT の ADsPath 構文に変換できます。GC のパスは LDAP 形式に変換できます。objectSid 属性を持つ WinNT オブジェクトは、DSOP_SCOPE_FLAG_WANT_SID_PATH フラグまたは DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP フラグを指定した場合に LDAP 形式へ変換できます。これら以外の変換は許可されません。 DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)この構造体が記述するスコープが、Look in ドロップダウン リストで最初に選択されます。このフラグを指定できるスコープは 1 つだけです。どのスコープもこのフラグを指定していない場合は、 IDsObjectPicker::Initialize メソッドに渡されたスコープの配列のうち、最初に作成に成功したスコープが初期スコープになります。 DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)ADsPath は WinNT プロバイダーを使用する形式に変換されます。詳細については、WinNT ADsPath を参照してください。 DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)ADsPath は LDAP プロバイダーを使用する形式に変換されます。詳細については、LDAP ADsPath を参照してください。 DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)このスコープから選択されたオブジェクトの ADsPath は、GC プロバイダーを使用する形式に変換されます。 DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)objectSid 属性を持つ ADsPath は、LDAP://<SID=x> の形式に変換されます。ここで x は objectSid 属性値の 16 進数の値を表します。 DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)ダウンレベルの well-known SID オブジェクト (たとえば DSOP_DOWNLEVEL_FILTER_INTERACTIVE) の ADsPath は、このフラグを指定しない限り空の文字列になります。このフラグを指定した場合、パスは次の形式になります。 WinNT://NT AUTHORITY/Interactive または WinNT://Creator owner。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)スコープのフィルターにユーザーが含まれる場合、ダイアログの Users チェック ボックスをオンにします。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)スコープのフィルターにグループが含まれる場合、ダイアログの Groups チェック ボックスをオンにします。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)スコープのフィルターにコンピューターが含まれる場合、ダイアログの Computers チェック ボックスをオンにします。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)スコープのフィルターに連絡先が含まれる場合、ダイアログの Contacts チェック ボックスをオンにします。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)スコープのフィルターにサービス アカウントが含まれる場合、ダイアログの Service Accounts チェック ボックスと Group Managed Service Accounts チェック ボックスをオンにします。 DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)スコープのフィルターにパスワード設定オブジェクトが含まれる場合、ダイアログの Password Setting Objects チェック ボックスをオンにします。 |
| FilterFlags | DSOP_FILTER_FLAGS | 16 | +12 | +12 | このスコープ (または複数のスコープ) についてユーザーに提示されるオブジェクトの種類を示す DSOP_FILTER_FLAGS 構造体を格納します。 |
| pwzDcName | LPWSTR | 8/4 | +32 | +28 | 対象のコンピューターが参加しているドメインのドメイン コントローラーの名前を格納する、null で終わる Unicode 文字列へのポインターです。このメンバーは、flType メンバーに DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN フラグが含まれている場合にのみ使用されます。そのフラグが設定されていない場合、pwzDcName は NULL でなければなりません。 DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN フラグが指定されている場合でも、このメンバーは NULL にできます。その場合、ダイアログ ボックスがドメイン コントローラーを検索します。このメンバーを使用すると、マルチマスター ドメイン内の特定のドメイン コントローラーを指定できます。たとえば、管理用アプリケーションがマルチマスター ドメイン内のドメイン コントローラーに変更を加え、その変更が他のドメイン コントローラーに複製される前にオブジェクト ピッカーのダイアログ ボックスを開く、といった場合に利用します。 |
| pwzADsPath | LPWSTR | 8/4 | +40 | +32 | 予約済みです。NULL でなければなりません。 |
| hr | HRESULT | 4 | +48 | +36 | 個々のスコープの状態を示す HRESULT 値を格納します。IDsObjectPicker::Initialize メソッドが、この構造体で指定されたスコープの作成に成功した場合、hr には S_OK が格納されます。それ以外の場合、hr にはエラー コードが格納されます。 IDsObjectPicker::Initialize が S_OK を返す場合、指定されたすべての DSOP_SCOPE_INIT_INFO 構造体の hr メンバーにも S_OK が格納されます。 |
公式ドキュメント
DSOP_SCOPE_INIT_INFO 構造体は、同じ属性を持つ 1 つ以上のスコープ型を記述します。スコープ型とは、ドメイン、コンピューター、グローバル カタログなど、ユーザーがオブジェクトを選択できる場所の種類です。 この構造体は、IDsObjectPicker::Initialize を呼び出すときに DSOP_INIT_INFO と共に使用します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DSOP_UPLEVEL_FILTER_FLAGS (x64 12 / x86 12 バイト)
typedef struct DSOP_UPLEVEL_FILTER_FLAGS {
DWORD flBothModes;
DWORD flMixedModeOnly;
DWORD flNativeModeOnly;
} DSOP_UPLEVEL_FILTER_FLAGS;
// DSOP_FILTER_FLAGS (x64 16 / x86 16 バイト)
typedef struct DSOP_FILTER_FLAGS {
DSOP_UPLEVEL_FILTER_FLAGS Uplevel;
DWORD flDownlevel;
} DSOP_FILTER_FLAGS;
// DSOP_SCOPE_INIT_INFO (x64 56 / x86 40 バイト)
typedef struct DSOP_SCOPE_INIT_INFO {
DWORD cbSize;
DWORD flType;
DWORD flScope;
DSOP_FILTER_FLAGS FilterFlags;
LPWSTR pwzDcName;
LPWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSOP_UPLEVEL_FILTER_FLAGS
{
public uint flBothModes;
public uint flMixedModeOnly;
public uint flNativeModeOnly;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSOP_FILTER_FLAGS
{
public DSOP_UPLEVEL_FILTER_FLAGS Uplevel;
public uint flDownlevel;
}
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSOP_SCOPE_INIT_INFO
{
public uint cbSize;
public uint flType;
public uint flScope;
public DSOP_FILTER_FLAGS FilterFlags;
public IntPtr pwzDcName;
public IntPtr pwzADsPath;
public int hr;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSOP_UPLEVEL_FILTER_FLAGS
Public flBothModes As UInteger
Public flMixedModeOnly As UInteger
Public flNativeModeOnly As UInteger
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSOP_FILTER_FLAGS
Public Uplevel As DSOP_UPLEVEL_FILTER_FLAGS
Public flDownlevel As UInteger
End Structure
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSOP_SCOPE_INIT_INFO
Public cbSize As UInteger
Public flType As UInteger
Public flScope As UInteger
Public FilterFlags As DSOP_FILTER_FLAGS
Public pwzDcName As IntPtr
Public pwzADsPath As IntPtr
Public hr As Integer
End Structureimport ctypes
from ctypes import wintypes
class DSOP_UPLEVEL_FILTER_FLAGS(ctypes.Structure):
_fields_ = [
("flBothModes", wintypes.DWORD),
("flMixedModeOnly", wintypes.DWORD),
("flNativeModeOnly", wintypes.DWORD),
]
class DSOP_FILTER_FLAGS(ctypes.Structure):
_fields_ = [
("Uplevel", DSOP_UPLEVEL_FILTER_FLAGS),
("flDownlevel", wintypes.DWORD),
]
class DSOP_SCOPE_INIT_INFO(ctypes.Structure):
_fields_ = [
("cbSize", wintypes.DWORD),
("flType", wintypes.DWORD),
("flScope", wintypes.DWORD),
("FilterFlags", DSOP_FILTER_FLAGS),
("pwzDcName", ctypes.c_void_p),
("pwzADsPath", ctypes.c_void_p),
("hr", ctypes.c_int),
]#[repr(C)]
pub struct DSOP_UPLEVEL_FILTER_FLAGS {
pub flBothModes: u32,
pub flMixedModeOnly: u32,
pub flNativeModeOnly: u32,
}
#[repr(C)]
pub struct DSOP_FILTER_FLAGS {
pub Uplevel: DSOP_UPLEVEL_FILTER_FLAGS,
pub flDownlevel: u32,
}
#[repr(C)]
pub struct DSOP_SCOPE_INIT_INFO {
pub cbSize: u32,
pub flType: u32,
pub flScope: u32,
pub FilterFlags: DSOP_FILTER_FLAGS,
pub pwzDcName: *mut core::ffi::c_void,
pub pwzADsPath: *mut core::ffi::c_void,
pub hr: i32,
}import "golang.org/x/sys/windows"
type DSOP_UPLEVEL_FILTER_FLAGS struct {
flBothModes uint32
flMixedModeOnly uint32
flNativeModeOnly uint32
}
type DSOP_FILTER_FLAGS struct {
Uplevel DSOP_UPLEVEL_FILTER_FLAGS
flDownlevel uint32
}
type DSOP_SCOPE_INIT_INFO struct {
cbSize uint32
flType uint32
flScope uint32
FilterFlags DSOP_FILTER_FLAGS
pwzDcName uintptr
pwzADsPath uintptr
hr int32
}type
DSOP_UPLEVEL_FILTER_FLAGS = record
flBothModes: DWORD;
flMixedModeOnly: DWORD;
flNativeModeOnly: DWORD;
end;
DSOP_FILTER_FLAGS = record
Uplevel: DSOP_UPLEVEL_FILTER_FLAGS;
flDownlevel: DWORD;
end;
DSOP_SCOPE_INIT_INFO = record
cbSize: DWORD;
flType: DWORD;
flScope: DWORD;
FilterFlags: DSOP_FILTER_FLAGS;
pwzDcName: Pointer;
pwzADsPath: Pointer;
hr: Integer;
end;const DSOP_UPLEVEL_FILTER_FLAGS = extern struct {
flBothModes: u32,
flMixedModeOnly: u32,
flNativeModeOnly: u32,
};
const DSOP_FILTER_FLAGS = extern struct {
Uplevel: DSOP_UPLEVEL_FILTER_FLAGS,
flDownlevel: u32,
};
const DSOP_SCOPE_INIT_INFO = extern struct {
cbSize: u32,
flType: u32,
flScope: u32,
FilterFlags: DSOP_FILTER_FLAGS,
pwzDcName: ?*anyopaque,
pwzADsPath: ?*anyopaque,
hr: i32,
};type
DSOP_UPLEVEL_FILTER_FLAGS {.bycopy.} = object
flBothModes: uint32
flMixedModeOnly: uint32
flNativeModeOnly: uint32
DSOP_FILTER_FLAGS {.bycopy.} = object
Uplevel: DSOP_UPLEVEL_FILTER_FLAGS
flDownlevel: uint32
DSOP_SCOPE_INIT_INFO {.bycopy.} = object
cbSize: uint32
flType: uint32
flScope: uint32
FilterFlags: DSOP_FILTER_FLAGS
pwzDcName: pointer
pwzADsPath: pointer
hr: int32struct DSOP_UPLEVEL_FILTER_FLAGS
{
uint flBothModes;
uint flMixedModeOnly;
uint flNativeModeOnly;
}
struct DSOP_FILTER_FLAGS
{
DSOP_UPLEVEL_FILTER_FLAGS Uplevel;
uint flDownlevel;
}
struct DSOP_SCOPE_INIT_INFO
{
uint cbSize;
uint flType;
uint flScope;
DSOP_FILTER_FLAGS FilterFlags;
void* pwzDcName;
void* pwzADsPath;
int hr;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DSOP_SCOPE_INIT_INFO サイズ: 40 バイト(x86)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; flType : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; flScope : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; FilterFlags : DSOP_FILTER_FLAGS (+12, 16byte) varptr(st)+12 を基点に操作(16byte:入れ子/配列)
; pwzDcName : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; pwzADsPath : LPWSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; hr : HRESULT (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DSOP_SCOPE_INIT_INFO サイズ: 56 バイト(x64)
dim st, 14 ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; flType : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; flScope : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; FilterFlags : DSOP_FILTER_FLAGS (+12, 16byte) varptr(st)+12 を基点に操作(16byte:入れ子/配列)
; pwzDcName : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pwzADsPath : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; hr : HRESULT (+48, 4byte) st.12 = 値 / 値 = st.12 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DSOP_UPLEVEL_FILTER_FLAGS
#field int flBothModes
#field int flMixedModeOnly
#field int flNativeModeOnly
#endstruct
#defstruct global DSOP_FILTER_FLAGS
#field DSOP_UPLEVEL_FILTER_FLAGS Uplevel
#field int flDownlevel
#endstruct
#defstruct global DSOP_SCOPE_INIT_INFO
#field int cbSize
#field int flType
#field int flScope
#field DSOP_FILTER_FLAGS FilterFlags
#field intptr pwzDcName
#field intptr pwzADsPath
#field int hr
#endstruct
stdim st, DSOP_SCOPE_INIT_INFO ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize