DFS_INFO_3
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| EntryPath | LPWSTR | 8/4 | +0 | +0 | DFS ルートまたはリンクの汎用名前付け規則 (UNC) パスを指定する、NULL で終わる Unicode 文字列への ポインターです。 リンクの場合、この文字列は 2 つの形式のいずれかを取ります。1 つ目の形式は次のとおりです。 \\ServerName\DfsName\link_path ここで ServerName は、スタンドアロン DFS 名前空間をホストするルート ターゲット サーバーの名前、 DfsName は DFS 名前空間の名前、 link_path は DFS リンクです。 2 つ目の形式は次のとおりです。 \\DomainName\DomDfsname\link_path ここで DomainName は、ドメインベースの DFS 名前空間をホストするドメインの名前、 DomDfsname は DFS 名前空間の名前、 link_path は DFS リンクです。 ルートの場合、この文字列は次の 2 つの形式のいずれかを取ります。 \\ServerName\DfsName または \\DomainName\DomDfsname 各名前の値は前述のものと同じです。 |
| Comment | LPWSTR | 8/4 | +8 | +4 | DFS ルートまたはリンクに関連付けられたコメントを格納する、NULL で終わる Unicode 文字列への ポインターです。 |
| State | DWORD | 4 | +16 | +8 | DFS ルートまたはリンクを表すビット フラグのセットを指定します。DFS_VOLUME_STATE フラグが 1 つ、 および DFS_VOLUME_FLAVOR フラグが 1 つ設定されます。DFS 名前空間のフレーバーを取り出すには DFS_VOLUME_FLAVORS ビットマスク (0x00000300) を、このメンバーから DFS ルートまたはリンクの状態を 取り出すには DFS_VOLUME_STATES ビットマスク (0x0000000F) を使用しなければなりません。 フラグの解釈を説明した例については、DFS_INFO_2 の解説セクションを参照してください。 DFS_VOLUME_STATE_OK (0x00000001)指定した DFS ルートまたはリンクは正常な状態です。 DFS_VOLUME_STATE_INCONSISTENT (0x00000002)内部の DFS データベースが、指定した DFS ルートまたはリンクと矛盾しています。不整合の修復は 失敗しました。 DFS_VOLUME_STATE_OFFLINE (0x00000003)指定した DFS ルートまたはリンクはオフラインであるか、利用できません。 DFS_VOLUME_STATE_ONLINE (0x00000004)指定した DFS ルートまたはリンクは利用可能です。 DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)ルートがスタンドアロン DFS 名前空間に関連付けられている場合、システムはこのフラグを設定します。 DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)ルートがドメインベースの DFS 名前空間に関連付けられている場合、システムはこのフラグを設定します。 |
| NumberOfStorages | DWORD | 4 | +20 | +12 | DFS ターゲットの数を指定します。 |
| Storage | DFS_STORAGE_INFO* | 8/4 | +24 | +16 | DFS_STORAGE_INFO 構造体の配列への ポインターです。配列内の構造体の数は NumberOfStorages メンバーで 指定されます。 |
公式ドキュメント
分散ファイル システム (DFS) のルートまたはリンクに関する情報を格納します。この構造体には、ルートまたはリンクの名前、 状態、DFS ターゲットの数、および各ターゲットに関する情報が含まれます。この構造体は、 NetDfsEnum、 NetDfsGetClientInfo、 NetDfsGetInfo の各関数と FSCTL_DFS_GET_PKT_ENTRY_STATE 制御コード でのみ使用します。
解説(Remarks)
DFS_INFO_3 構造体には、DFS ターゲットごとに 1 つずつ、1 つ以上の DFS_STORAGE_INFO 構造体が 含まれます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DFS_INFO_3 (x64 32 / x86 20 バイト)
typedef struct DFS_INFO_3 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
DWORD NumberOfStorages;
DFS_STORAGE_INFO* Storage;
} DFS_INFO_3;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DFS_INFO_3
{
public IntPtr EntryPath;
public IntPtr Comment;
public uint State;
public uint NumberOfStorages;
public IntPtr Storage;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DFS_INFO_3
Public EntryPath As IntPtr
Public Comment As IntPtr
Public State As UInteger
Public NumberOfStorages As UInteger
Public Storage As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class DFS_INFO_3(ctypes.Structure):
_fields_ = [
("EntryPath", ctypes.c_void_p),
("Comment", ctypes.c_void_p),
("State", wintypes.DWORD),
("NumberOfStorages", wintypes.DWORD),
("Storage", ctypes.c_void_p),
]#[repr(C)]
pub struct DFS_INFO_3 {
pub EntryPath: *mut core::ffi::c_void,
pub Comment: *mut core::ffi::c_void,
pub State: u32,
pub NumberOfStorages: u32,
pub Storage: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type DFS_INFO_3 struct {
EntryPath uintptr
Comment uintptr
State uint32
NumberOfStorages uint32
Storage uintptr
}type
DFS_INFO_3 = record
EntryPath: Pointer;
Comment: Pointer;
State: DWORD;
NumberOfStorages: DWORD;
Storage: Pointer;
end;const DFS_INFO_3 = extern struct {
EntryPath: ?*anyopaque,
Comment: ?*anyopaque,
State: u32,
NumberOfStorages: u32,
Storage: ?*anyopaque,
};type
DFS_INFO_3 {.bycopy.} = object
EntryPath: pointer
Comment: pointer
State: uint32
NumberOfStorages: uint32
Storage: pointerstruct DFS_INFO_3
{
void* EntryPath;
void* Comment;
uint State;
uint NumberOfStorages;
void* Storage;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DFS_INFO_3 サイズ: 20 バイト(x86)
dim st, 5 ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; EntryPath : LPWSTR (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Comment : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; State : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; NumberOfStorages : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Storage : DFS_STORAGE_INFO* (+16, 4byte) varptr(st)+16 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DFS_INFO_3 サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; EntryPath : LPWSTR (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; Comment : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; State : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; NumberOfStorages : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; Storage : DFS_STORAGE_INFO* (+24, 8byte) varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DFS_INFO_3
#field intptr EntryPath
#field intptr Comment
#field int State
#field int NumberOfStorages
#field intptr Storage
#endstruct
stdim st, DFS_INFO_3 ; NSTRUCT 変数を確保
st->State = 100
mes "State=" + st->State