Win32 API 日本語リファレンス
ホームNetworkManagement.WNet › NETRESOURCEW

NETRESOURCEW

構造体
サイズx64: 48 バイト / x86: 32 バイト

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

フィールド

フィールドサイズx64x86説明
dwScopeNET_RESOURCE_SCOPE4+0+0

列挙のスコープを示します。次のいずれかの値を指定できます。

意味
RESOURCE_CONNECTED
ネットワーク リソースへの現在の接続。
RESOURCE_GLOBALNET
すべてのネットワーク リソース。接続されている場合とされていない場合があります。
RESOURCE_CONTEXT
ユーザーの現在および既定のネットワーク コンテキストに関連付けられたネットワーク リソース。この意味はプロバイダー固有です。
dwTypeNET_RESOURCE_TYPE4+4+4

リソースの種類を示します。次のいずれかの値を指定できます。

意味
RESOURCETYPE_DISK
リソースは共有ディスク ボリュームです。
RESOURCETYPE_PRINT
リソースは共有プリンターです。
RESOURCETYPE_ANY
リソースが複数の種類に一致します。たとえば、プリント リソースとディスク リソースの両方を含むコンテナーや、プリントでもディスクでもないリソースです。
dwDisplayTypeDWORD4+8+8

このリソースを表現する際にユーザー インターフェイスが使用すべき表示種別を示すために、プロバイダーによって設定されます。次の種別が定義されています。

意味
RESOURCEDISPLAYTYPE_NETWORK
リソースはネットワーク プロバイダーです。
RESOURCEDISPLAYTYPE_DOMAIN
リソースはサーバーの集まりです。
RESOURCEDISPLAYTYPE_SERVER
リソースはサーバーです。
RESOURCEDISPLAYTYPE_SHARE
リソースは共有ポイントです。
RESOURCEDISPLAYTYPE_DIRECTORY
リソースはディレクトリです。
RESOURCEDISPLAYTYPE_GENERIC
リソースの種類が指定されていません。この値は、リソースの種類を指定しないネットワーク プロバイダーによって使用されます。
dwUsageDWORD4+12+12

リソースに関する情報をどのように列挙できるかを示すビットマスクです。dwScopeRESOURCE_GLOBALNET に設定されている場合にのみ定義されます。dwUsage フィールドには、次のフラグを 1 つ以上含めることができます。

意味
RESOURCEUSAGE_CONNECTABLE
NPAddConnection を呼び出すことでリソースに接続できます。dwTypeRESOURCETYPE_DISK の場合、リソースに接続した後、 FindFirstFileFindNextFile などのファイル システム API を使用して、リソースに含まれるファイルとディレクトリを列挙できます。
RESOURCEUSAGE_CONTAINER
リソースは、 NPOpenEnumNPEnumResourceNPCloseEnum の各関数を使用して列挙できる他のリソースのコンテナーです。

ただし、列挙を行った時点でコンテナーが空であることもあります。つまり、NPEnumResource の最初の呼び出しが WN_NO_MORE_ENTRIES を返す場合があります。

lpLocalNameLPWSTR8/4+16+16

dwScopeRESOURCE_CONNECTED の場合、lpLocalName フィールドにはリダイレクトされたデバイスの名前が格納されます。接続がデバイスレス接続の場合、このフィールドは NULL になります。

dwScopeRESOURCE_CONNECTED に設定されていない場合、このフィールドは未定義です。

lpRemoteNameLPWSTR8/4+24+20列挙された項目がネットワーク リソースの場合、このフィールドにはリモート ネットワーク名が格納されます。dwUsageRESOURCEUSAGE_CONNECTABLE に設定されている場合、この名前を NPAddConnection に渡してネットワーク接続を確立できます。列挙された項目が現在の接続の場合、このフィールドは lpLocalName の接続先であるリモート ネットワーク名を参照します。
lpCommentLPWSTR8/4+32+24列挙された項目に関連付けられた、プロバイダーが提供する任意のコメントです。
lpProviderLPWSTR8/4+40+28この列挙された項目を所有するプロバイダーの名前を指定します。

公式ドキュメント

この構造体には、ネットワーク リソースに関する情報が含まれます。 NPOpenEnumNPAddConnection など、いくつかのネットワーク プロバイダー関数で使用されます。

解説(Remarks)

メモ

winnetwk.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして NETRESOURCE を定義しています。エンコーディングに依存しないエイリアスの使用を、エンコーディング中立でないコードと混在させると、コンパイル エラーや実行時エラーにつながる不一致が発生する可能性があります。詳細については、関数プロトタイプの規約を参照してください。

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

各言語での定義

#include <windows.h>

// NETRESOURCEW  (x64 48 / x86 32 バイト)
typedef struct NETRESOURCEW {
    NET_RESOURCE_SCOPE dwScope;
    NET_RESOURCE_TYPE dwType;
    DWORD dwDisplayType;
    DWORD dwUsage;
    LPWSTR lpLocalName;
    LPWSTR lpRemoteName;
    LPWSTR lpComment;
    LPWSTR lpProvider;
} NETRESOURCEW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NETRESOURCEW
{
    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 NETRESOURCEW
    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 Structure
import ctypes
from ctypes import wintypes

class NETRESOURCEW(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 NETRESOURCEW {
    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 NETRESOURCEW struct {
	dwScope uint32
	dwType uint32
	dwDisplayType uint32
	dwUsage uint32
	lpLocalName uintptr
	lpRemoteName uintptr
	lpComment uintptr
	lpProvider uintptr
}
type
  NETRESOURCEW = record
    dwScope: DWORD;
    dwType: DWORD;
    dwDisplayType: DWORD;
    dwUsage: DWORD;
    lpLocalName: Pointer;
    lpRemoteName: Pointer;
    lpComment: Pointer;
    lpProvider: Pointer;
  end;
const NETRESOURCEW = extern struct {
    dwScope: u32,
    dwType: u32,
    dwDisplayType: u32,
    dwUsage: u32,
    lpLocalName: ?*anyopaque,
    lpRemoteName: ?*anyopaque,
    lpComment: ?*anyopaque,
    lpProvider: ?*anyopaque,
};
type
  NETRESOURCEW {.bycopy.} = object
    dwScope: uint32
    dwType: uint32
    dwDisplayType: uint32
    dwUsage: uint32
    lpLocalName: pointer
    lpRemoteName: pointer
    lpComment: pointer
    lpProvider: pointer
struct NETRESOURCEW
{
    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 レイアウト)
; NETRESOURCEW サイズ: 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 : LPWSTR (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpRemoteName : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpComment : LPWSTR (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; lpProvider : LPWSTR (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NETRESOURCEW サイズ: 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 : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; lpRemoteName : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; lpComment : LPWSTR (+32, 8byte)  qpoke st,32,値 / qpeek(st,32)  ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; lpProvider : LPWSTR (+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 NETRESOURCEW
    #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, NETRESOURCEW        ; NSTRUCT 変数を確保
st->dwScope = 100
mes "dwScope=" + st->dwScope