NETRESOURCEA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwScope | NET_RESOURCE_SCOPE | 4 | +0 | +0 | 列挙のスコープを示します。次のいずれかの値を指定できます。
| ||||||||||||||
| dwType | NET_RESOURCE_TYPE | 4 | +4 | +4 | リソースの種類を示します。次のいずれかの値を指定できます。
| ||||||||||||||
| dwDisplayType | DWORD | 4 | +8 | +8 | このリソースを表現するためにユーザー インターフェイスが使用すべき表示タイプを示すために、プロバイダーによって設定されます。次の種類が定義されています。
| ||||||||||||||
| dwUsage | DWORD | 4 | +12 | +12 | リソースに関する情報をどのように列挙できるかを示すビットマスクです。dwScope が RESOURCE_GLOBALNET に設定されている場合にのみ定義されます。dwUsage フィールドには、次のフラグを 1 つ以上含めることができます。
| ||||||||||||||
| lpLocalName | LPSTR | 8/4 | +16 | +16 | dwScope が RESOURCE_CONNECTED の場合、lpLocalName フィールドにはリダイレクトされたデバイスの名前が含まれます。接続がデバイスレス接続の場合、このフィールドには NULL が含まれます。 dwScope が RESOURCE_CONNECTED に設定されていない場合、このフィールドは未定義です。 | ||||||||||||||
| lpRemoteName | LPSTR | 8/4 | +24 | +20 | 列挙された項目がネットワーク リソースの場合、このフィールドにはリモート ネットワーク名が含まれます。dwUsage が RESOURCEUSAGE_CONNECTABLE に設定されている場合、この名前を NPAddConnection に渡してネットワーク接続を確立できます。列挙された項目が現在の接続である場合、このフィールドは lpLocalName の接続先のリモート ネットワーク名を参照します。 | ||||||||||||||
| lpComment | LPSTR | 8/4 | +32 | +24 | 列挙された項目に関連付けられた、プロバイダーが提供する任意のコメントです。 | ||||||||||||||
| lpProvider | LPSTR | 8/4 | +40 | +28 | この列挙項目を所有するプロバイダーの名前を指定します。 |
公式ドキュメント
この構造体には、ネットワーク リソースに関する情報が含まれます。 NPOpenEnum や NPAddConnection など、いくつかのネットワーク プロバイダー関数で使用されます。
解説(Remarks)
winnetwk.h ヘッダーは、NETRESOURCE を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義しています。エンコーディング中立のエイリアスを、エンコーディング中立ではないコードと混在させると、コンパイル エラーや実行時エラーにつながる不一致が発生する可能性があります。詳細については、関数プロトタイプの規約 を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// NETRESOURCEA (x64 48 / x86 32 バイト)
typedef struct NETRESOURCEA {
NET_RESOURCE_SCOPE dwScope;
NET_RESOURCE_TYPE dwType;
DWORD dwDisplayType;
DWORD dwUsage;
LPSTR lpLocalName;
LPSTR lpRemoteName;
LPSTR lpComment;
LPSTR lpProvider;
} NETRESOURCEA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NETRESOURCEA
{
public uint dwScope;
public uint dwType;
public uint dwDisplayType;
public uint dwUsage;
public IntPtr lpLocalName;
public IntPtr lpRemoteName;
public IntPtr lpComment;
public IntPtr lpProvider;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NETRESOURCEA
Public dwScope As UInteger
Public dwType As UInteger
Public dwDisplayType As UInteger
Public dwUsage As UInteger
Public lpLocalName As IntPtr
Public lpRemoteName As IntPtr
Public lpComment As IntPtr
Public lpProvider As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class NETRESOURCEA(ctypes.Structure):
_fields_ = [
("dwScope", wintypes.DWORD),
("dwType", wintypes.DWORD),
("dwDisplayType", wintypes.DWORD),
("dwUsage", wintypes.DWORD),
("lpLocalName", ctypes.c_void_p),
("lpRemoteName", ctypes.c_void_p),
("lpComment", ctypes.c_void_p),
("lpProvider", ctypes.c_void_p),
]#[repr(C)]
pub struct NETRESOURCEA {
pub dwScope: u32,
pub dwType: u32,
pub dwDisplayType: u32,
pub dwUsage: u32,
pub lpLocalName: *mut core::ffi::c_void,
pub lpRemoteName: *mut core::ffi::c_void,
pub lpComment: *mut core::ffi::c_void,
pub lpProvider: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type NETRESOURCEA struct {
dwScope uint32
dwType uint32
dwDisplayType uint32
dwUsage uint32
lpLocalName uintptr
lpRemoteName uintptr
lpComment uintptr
lpProvider uintptr
}type
NETRESOURCEA = record
dwScope: DWORD;
dwType: DWORD;
dwDisplayType: DWORD;
dwUsage: DWORD;
lpLocalName: Pointer;
lpRemoteName: Pointer;
lpComment: Pointer;
lpProvider: Pointer;
end;const NETRESOURCEA = extern struct {
dwScope: u32,
dwType: u32,
dwDisplayType: u32,
dwUsage: u32,
lpLocalName: ?*anyopaque,
lpRemoteName: ?*anyopaque,
lpComment: ?*anyopaque,
lpProvider: ?*anyopaque,
};type
NETRESOURCEA {.bycopy.} = object
dwScope: uint32
dwType: uint32
dwDisplayType: uint32
dwUsage: uint32
lpLocalName: pointer
lpRemoteName: pointer
lpComment: pointer
lpProvider: pointerstruct NETRESOURCEA
{
uint dwScope;
uint dwType;
uint dwDisplayType;
uint dwUsage;
void* lpLocalName;
void* lpRemoteName;
void* lpComment;
void* lpProvider;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; NETRESOURCEA サイズ: 32 バイト(x86)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; dwScope : NET_RESOURCE_SCOPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwType : NET_RESOURCE_TYPE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwDisplayType : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwUsage : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpLocalName : LPSTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; lpRemoteName : LPSTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; lpComment : LPSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; lpProvider : LPSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NETRESOURCEA サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; dwScope : NET_RESOURCE_SCOPE (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwType : NET_RESOURCE_TYPE (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; dwDisplayType : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; dwUsage : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; lpLocalName : LPSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpRemoteName : LPSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpComment : LPSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpProvider : LPSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NETRESOURCEA
#field int dwScope
#field int dwType
#field int dwDisplayType
#field int dwUsage
#field intptr lpLocalName
#field intptr lpRemoteName
#field intptr lpComment
#field intptr lpProvider
#endstruct
stdim st, NETRESOURCEA ; NSTRUCT 変数を確保
st->dwScope = 100
mes "dwScope=" + st->dwScope