ホーム › NetworkManagement.IpHelper › GetNetworkInformation
GetNetworkInformation
関数GUIDで指定したネットワークのコンパートメントやサイトIDなどの情報を取得する。
シグネチャ
// IPHLPAPI.dll
#include <windows.h>
WIN32_ERROR GetNetworkInformation(
const GUID* NetworkGuid,
DWORD* CompartmentId,
DWORD* SiteId,
LPWSTR NetworkName,
DWORD Length
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| NetworkGuid | GUID* | in |
| CompartmentId | DWORD* | out |
| SiteId | DWORD* | out |
| NetworkName | LPWSTR | out |
| Length | DWORD | in |
戻り値の型: WIN32_ERROR
各言語での呼び出し定義
// IPHLPAPI.dll
#include <windows.h>
WIN32_ERROR GetNetworkInformation(
const GUID* NetworkGuid,
DWORD* CompartmentId,
DWORD* SiteId,
LPWSTR NetworkName,
DWORD Length
);[DllImport("IPHLPAPI.dll", ExactSpelling = true)]
static extern uint GetNetworkInformation(
ref Guid NetworkGuid, // GUID*
out uint CompartmentId, // DWORD* out
out uint SiteId, // DWORD* out
[MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder NetworkName, // LPWSTR out
uint Length // DWORD
);<DllImport("IPHLPAPI.dll", ExactSpelling:=True)>
Public Shared Function GetNetworkInformation(
ByRef NetworkGuid As Guid, ' GUID*
<Out> ByRef CompartmentId As UInteger, ' DWORD* out
<Out> ByRef SiteId As UInteger, ' DWORD* out
<MarshalAs(UnmanagedType.LPWStr)> NetworkName As System.Text.StringBuilder, ' LPWSTR out
Length As UInteger ' DWORD
) As UInteger
End Function' NetworkGuid : GUID*
' CompartmentId : DWORD* out
' SiteId : DWORD* out
' NetworkName : LPWSTR out
' Length : DWORD
Declare PtrSafe Function GetNetworkInformation Lib "iphlpapi" ( _
ByVal NetworkGuid As LongPtr, _
ByRef CompartmentId As Long, _
ByRef SiteId As Long, _
ByVal NetworkName As LongPtr, _
ByVal Length As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
GetNetworkInformation = ctypes.windll.iphlpapi.GetNetworkInformation
GetNetworkInformation.restype = wintypes.DWORD
GetNetworkInformation.argtypes = [
ctypes.c_void_p, # NetworkGuid : GUID*
ctypes.POINTER(wintypes.DWORD), # CompartmentId : DWORD* out
ctypes.POINTER(wintypes.DWORD), # SiteId : DWORD* out
wintypes.LPWSTR, # NetworkName : LPWSTR out
wintypes.DWORD, # Length : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('IPHLPAPI.dll')
GetNetworkInformation = Fiddle::Function.new(
lib['GetNetworkInformation'],
[
Fiddle::TYPE_VOIDP, # NetworkGuid : GUID*
Fiddle::TYPE_VOIDP, # CompartmentId : DWORD* out
Fiddle::TYPE_VOIDP, # SiteId : DWORD* out
Fiddle::TYPE_VOIDP, # NetworkName : LPWSTR out
-Fiddle::TYPE_INT, # Length : DWORD
],
-Fiddle::TYPE_INT)#[link(name = "iphlpapi")]
extern "system" {
fn GetNetworkInformation(
NetworkGuid: *const GUID, // GUID*
CompartmentId: *mut u32, // DWORD* out
SiteId: *mut u32, // DWORD* out
NetworkName: *mut u16, // LPWSTR out
Length: u32 // DWORD
) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("IPHLPAPI.dll")]
public static extern uint GetNetworkInformation(ref Guid NetworkGuid, out uint CompartmentId, out uint SiteId, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder NetworkName, uint Length);
"@
$api = Add-Type -MemberDefinition $sig -Name 'IPHLPAPI_GetNetworkInformation' -Namespace Win32 -PassThru
# $api::GetNetworkInformation(NetworkGuid, CompartmentId, SiteId, NetworkName, Length)#uselib "IPHLPAPI.dll"
#func global GetNetworkInformation "GetNetworkInformation" sptr, sptr, sptr, sptr, sptr
; GetNetworkInformation varptr(NetworkGuid), varptr(CompartmentId), varptr(SiteId), varptr(NetworkName), Length ; 戻り値は stat
; NetworkGuid : GUID* -> "sptr"
; CompartmentId : DWORD* out -> "sptr"
; SiteId : DWORD* out -> "sptr"
; NetworkName : LPWSTR out -> "sptr"
; Length : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "IPHLPAPI.dll" #cfunc global GetNetworkInformation "GetNetworkInformation" var, var, var, var, int ; res = GetNetworkInformation(NetworkGuid, CompartmentId, SiteId, NetworkName, Length) ; NetworkGuid : GUID* -> "var" ; CompartmentId : DWORD* out -> "var" ; SiteId : DWORD* out -> "var" ; NetworkName : LPWSTR out -> "var" ; Length : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "IPHLPAPI.dll" #cfunc global GetNetworkInformation "GetNetworkInformation" sptr, sptr, sptr, sptr, int ; res = GetNetworkInformation(varptr(NetworkGuid), varptr(CompartmentId), varptr(SiteId), varptr(NetworkName), Length) ; NetworkGuid : GUID* -> "sptr" ; CompartmentId : DWORD* out -> "sptr" ; SiteId : DWORD* out -> "sptr" ; NetworkName : LPWSTR out -> "sptr" ; Length : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; WIN32_ERROR GetNetworkInformation(GUID* NetworkGuid, DWORD* CompartmentId, DWORD* SiteId, LPWSTR NetworkName, DWORD Length) #uselib "IPHLPAPI.dll" #cfunc global GetNetworkInformation "GetNetworkInformation" var, var, var, var, int ; res = GetNetworkInformation(NetworkGuid, CompartmentId, SiteId, NetworkName, Length) ; NetworkGuid : GUID* -> "var" ; CompartmentId : DWORD* out -> "var" ; SiteId : DWORD* out -> "var" ; NetworkName : LPWSTR out -> "var" ; Length : DWORD -> "int" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; WIN32_ERROR GetNetworkInformation(GUID* NetworkGuid, DWORD* CompartmentId, DWORD* SiteId, LPWSTR NetworkName, DWORD Length) #uselib "IPHLPAPI.dll" #cfunc global GetNetworkInformation "GetNetworkInformation" intptr, intptr, intptr, intptr, int ; res = GetNetworkInformation(varptr(NetworkGuid), varptr(CompartmentId), varptr(SiteId), varptr(NetworkName), Length) ; NetworkGuid : GUID* -> "intptr" ; CompartmentId : DWORD* out -> "intptr" ; SiteId : DWORD* out -> "intptr" ; NetworkName : LPWSTR out -> "intptr" ; Length : DWORD -> "int" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
iphlpapi = windows.NewLazySystemDLL("IPHLPAPI.dll")
procGetNetworkInformation = iphlpapi.NewProc("GetNetworkInformation")
)
// NetworkGuid (GUID*), CompartmentId (DWORD* out), SiteId (DWORD* out), NetworkName (LPWSTR out), Length (DWORD)
r1, _, err := procGetNetworkInformation.Call(
uintptr(NetworkGuid),
uintptr(CompartmentId),
uintptr(SiteId),
uintptr(NetworkName),
uintptr(Length),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // WIN32_ERRORfunction GetNetworkInformation(
NetworkGuid: PGUID; // GUID*
CompartmentId: Pointer; // DWORD* out
SiteId: Pointer; // DWORD* out
NetworkName: PWideChar; // LPWSTR out
Length: DWORD // DWORD
): DWORD; stdcall;
external 'IPHLPAPI.dll' name 'GetNetworkInformation';result := DllCall("IPHLPAPI\GetNetworkInformation"
, "Ptr", NetworkGuid ; GUID*
, "Ptr", CompartmentId ; DWORD* out
, "Ptr", SiteId ; DWORD* out
, "Ptr", NetworkName ; LPWSTR out
, "UInt", Length ; DWORD
, "UInt") ; return: WIN32_ERROR●GetNetworkInformation(NetworkGuid, CompartmentId, SiteId, NetworkName, Length) = DLL("IPHLPAPI.dll", "dword GetNetworkInformation(void*, void*, void*, char*, dword)")
# 呼び出し: GetNetworkInformation(NetworkGuid, CompartmentId, SiteId, NetworkName, Length)
# NetworkGuid : GUID* -> "void*"
# CompartmentId : DWORD* out -> "void*"
# SiteId : DWORD* out -> "void*"
# NetworkName : LPWSTR out -> "char*"
# Length : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。