ホーム › Networking.WinInet › ReadGuidsForConnectedNetworks

ReadGuidsForConnectedNetworks

関数

接続中ネットワークのGUIDや名前などの情報を取得する。

DLLWININET.dll呼出規約winapi

シグネチャ

// WININET.dll
#include <windows.h>

BOOL ReadGuidsForConnectedNetworks(
    DWORD* pcNetworks,   // optional
    LPWSTR** pppwszNetworkGuids,   // optional
    LPWSTR** pppbstrNetworkNames,   // optional
    LPWSTR** pppwszGWMacs,   // optional
    DWORD* pcGatewayMacs,   // optional
    DWORD* pdwFlags   // optional
);

パラメーター

名前	型	方向
pcNetworks	DWORD*	outoptional
pppwszNetworkGuids	LPWSTR**	outoptional
pppbstrNetworkNames	LPWSTR**	outoptional
pppwszGWMacs	LPWSTR**	outoptional
pcGatewayMacs	DWORD*	outoptional
pdwFlags	DWORD*	outoptional

戻り値の型: BOOL

各言語での呼び出し定義

// WININET.dll
#include <windows.h>

BOOL ReadGuidsForConnectedNetworks(
    DWORD* pcNetworks,   // optional
    LPWSTR** pppwszNetworkGuids,   // optional
    LPWSTR** pppbstrNetworkNames,   // optional
    LPWSTR** pppwszGWMacs,   // optional
    DWORD* pcGatewayMacs,   // optional
    DWORD* pdwFlags   // optional
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("WININET.dll", ExactSpelling = true)]
static extern bool ReadGuidsForConnectedNetworks(
    IntPtr pcNetworks,   // DWORD* optional, out
    IntPtr pppwszNetworkGuids,   // LPWSTR** optional, out
    IntPtr pppbstrNetworkNames,   // LPWSTR** optional, out
    IntPtr pppwszGWMacs,   // LPWSTR** optional, out
    IntPtr pcGatewayMacs,   // DWORD* optional, out
    IntPtr pdwFlags   // DWORD* optional, out
);

<DllImport("WININET.dll", ExactSpelling:=True)>
Public Shared Function ReadGuidsForConnectedNetworks(
    pcNetworks As IntPtr,   ' DWORD* optional, out
    pppwszNetworkGuids As IntPtr,   ' LPWSTR** optional, out
    pppbstrNetworkNames As IntPtr,   ' LPWSTR** optional, out
    pppwszGWMacs As IntPtr,   ' LPWSTR** optional, out
    pcGatewayMacs As IntPtr,   ' DWORD* optional, out
    pdwFlags As IntPtr   ' DWORD* optional, out
) As Boolean
End Function

' pcNetworks : DWORD* optional, out
' pppwszNetworkGuids : LPWSTR** optional, out
' pppbstrNetworkNames : LPWSTR** optional, out
' pppwszGWMacs : LPWSTR** optional, out
' pcGatewayMacs : DWORD* optional, out
' pdwFlags : DWORD* optional, out
Declare PtrSafe Function ReadGuidsForConnectedNetworks Lib "wininet" ( _
    ByVal pcNetworks As LongPtr, _
    ByVal pppwszNetworkGuids As LongPtr, _
    ByVal pppbstrNetworkNames As LongPtr, _
    ByVal pppwszGWMacs As LongPtr, _
    ByVal pcGatewayMacs As LongPtr, _
    ByVal pdwFlags As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

ReadGuidsForConnectedNetworks = ctypes.windll.wininet.ReadGuidsForConnectedNetworks
ReadGuidsForConnectedNetworks.restype = wintypes.BOOL
ReadGuidsForConnectedNetworks.argtypes = [
    ctypes.POINTER(wintypes.DWORD),  # pcNetworks : DWORD* optional, out
    ctypes.c_void_p,  # pppwszNetworkGuids : LPWSTR** optional, out
    ctypes.c_void_p,  # pppbstrNetworkNames : LPWSTR** optional, out
    ctypes.c_void_p,  # pppwszGWMacs : LPWSTR** optional, out
    ctypes.POINTER(wintypes.DWORD),  # pcGatewayMacs : DWORD* optional, out
    ctypes.POINTER(wintypes.DWORD),  # pdwFlags : DWORD* optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WININET.dll')
ReadGuidsForConnectedNetworks = Fiddle::Function.new(
  lib['ReadGuidsForConnectedNetworks'],
  [
    Fiddle::TYPE_VOIDP,  # pcNetworks : DWORD* optional, out
    Fiddle::TYPE_VOIDP,  # pppwszNetworkGuids : LPWSTR** optional, out
    Fiddle::TYPE_VOIDP,  # pppbstrNetworkNames : LPWSTR** optional, out
    Fiddle::TYPE_VOIDP,  # pppwszGWMacs : LPWSTR** optional, out
    Fiddle::TYPE_VOIDP,  # pcGatewayMacs : DWORD* optional, out
    Fiddle::TYPE_VOIDP,  # pdwFlags : DWORD* optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "wininet")]
extern "system" {
    fn ReadGuidsForConnectedNetworks(
        pcNetworks: *mut u32,  // DWORD* optional, out
        pppwszNetworkGuids: *mut *mut *mut u16,  // LPWSTR** optional, out
        pppbstrNetworkNames: *mut *mut *mut u16,  // LPWSTR** optional, out
        pppwszGWMacs: *mut *mut *mut u16,  // LPWSTR** optional, out
        pcGatewayMacs: *mut u32,  // DWORD* optional, out
        pdwFlags: *mut u32  // DWORD* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("WININET.dll")]
public static extern bool ReadGuidsForConnectedNetworks(IntPtr pcNetworks, IntPtr pppwszNetworkGuids, IntPtr pppbstrNetworkNames, IntPtr pppwszGWMacs, IntPtr pcGatewayMacs, IntPtr pdwFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WININET_ReadGuidsForConnectedNetworks' -Namespace Win32 -PassThru
# $api::ReadGuidsForConnectedNetworks(pcNetworks, pppwszNetworkGuids, pppbstrNetworkNames, pppwszGWMacs, pcGatewayMacs, pdwFlags)

#uselib "WININET.dll"
#func global ReadGuidsForConnectedNetworks "ReadGuidsForConnectedNetworks" sptr, sptr, sptr, sptr, sptr, sptr
; ReadGuidsForConnectedNetworks varptr(pcNetworks), varptr(pppwszNetworkGuids), varptr(pppbstrNetworkNames), varptr(pppwszGWMacs), varptr(pcGatewayMacs), varptr(pdwFlags)   ; 戻り値は stat
; pcNetworks : DWORD* optional, out -> "sptr"
; pppwszNetworkGuids : LPWSTR** optional, out -> "sptr"
; pppbstrNetworkNames : LPWSTR** optional, out -> "sptr"
; pppwszGWMacs : LPWSTR** optional, out -> "sptr"
; pcGatewayMacs : DWORD* optional, out -> "sptr"
; pdwFlags : DWORD* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "WININET.dll"
#cfunc global ReadGuidsForConnectedNetworks "ReadGuidsForConnectedNetworks" var, var, var, var, var, var
; res = ReadGuidsForConnectedNetworks(pcNetworks, pppwszNetworkGuids, pppbstrNetworkNames, pppwszGWMacs, pcGatewayMacs, pdwFlags)
; pcNetworks : DWORD* optional, out -> "var"
; pppwszNetworkGuids : LPWSTR** optional, out -> "var"
; pppbstrNetworkNames : LPWSTR** optional, out -> "var"
; pppwszGWMacs : LPWSTR** optional, out -> "var"
; pcGatewayMacs : DWORD* optional, out -> "var"
; pdwFlags : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WININET.dll"
#cfunc global ReadGuidsForConnectedNetworks "ReadGuidsForConnectedNetworks" sptr, sptr, sptr, sptr, sptr, sptr
; res = ReadGuidsForConnectedNetworks(varptr(pcNetworks), varptr(pppwszNetworkGuids), varptr(pppbstrNetworkNames), varptr(pppwszGWMacs), varptr(pcGatewayMacs), varptr(pdwFlags))
; pcNetworks : DWORD* optional, out -> "sptr"
; pppwszNetworkGuids : LPWSTR** optional, out -> "sptr"
; pppbstrNetworkNames : LPWSTR** optional, out -> "sptr"
; pppwszGWMacs : LPWSTR** optional, out -> "sptr"
; pcGatewayMacs : DWORD* optional, out -> "sptr"
; pdwFlags : DWORD* optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; BOOL ReadGuidsForConnectedNetworks(DWORD* pcNetworks, LPWSTR** pppwszNetworkGuids, LPWSTR** pppbstrNetworkNames, LPWSTR** pppwszGWMacs, DWORD* pcGatewayMacs, DWORD* pdwFlags)
#uselib "WININET.dll"
#cfunc global ReadGuidsForConnectedNetworks "ReadGuidsForConnectedNetworks" var, var, var, var, var, var
; res = ReadGuidsForConnectedNetworks(pcNetworks, pppwszNetworkGuids, pppbstrNetworkNames, pppwszGWMacs, pcGatewayMacs, pdwFlags)
; pcNetworks : DWORD* optional, out -> "var"
; pppwszNetworkGuids : LPWSTR** optional, out -> "var"
; pppbstrNetworkNames : LPWSTR** optional, out -> "var"
; pppwszGWMacs : LPWSTR** optional, out -> "var"
; pcGatewayMacs : DWORD* optional, out -> "var"
; pdwFlags : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL ReadGuidsForConnectedNetworks(DWORD* pcNetworks, LPWSTR** pppwszNetworkGuids, LPWSTR** pppbstrNetworkNames, LPWSTR** pppwszGWMacs, DWORD* pcGatewayMacs, DWORD* pdwFlags)
#uselib "WININET.dll"
#cfunc global ReadGuidsForConnectedNetworks "ReadGuidsForConnectedNetworks" intptr, intptr, intptr, intptr, intptr, intptr
; res = ReadGuidsForConnectedNetworks(varptr(pcNetworks), varptr(pppwszNetworkGuids), varptr(pppbstrNetworkNames), varptr(pppwszGWMacs), varptr(pcGatewayMacs), varptr(pdwFlags))
; pcNetworks : DWORD* optional, out -> "intptr"
; pppwszNetworkGuids : LPWSTR** optional, out -> "intptr"
; pppbstrNetworkNames : LPWSTR** optional, out -> "intptr"
; pppwszGWMacs : LPWSTR** optional, out -> "intptr"
; pcGatewayMacs : DWORD* optional, out -> "intptr"
; pdwFlags : DWORD* optional, out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	wininet = windows.NewLazySystemDLL("WININET.dll")
	procReadGuidsForConnectedNetworks = wininet.NewProc("ReadGuidsForConnectedNetworks")
)

// pcNetworks (DWORD* optional, out), pppwszNetworkGuids (LPWSTR** optional, out), pppbstrNetworkNames (LPWSTR** optional, out), pppwszGWMacs (LPWSTR** optional, out), pcGatewayMacs (DWORD* optional, out), pdwFlags (DWORD* optional, out)
r1, _, err := procReadGuidsForConnectedNetworks.Call(
	uintptr(pcNetworks),
	uintptr(pppwszNetworkGuids),
	uintptr(pppbstrNetworkNames),
	uintptr(pppwszGWMacs),
	uintptr(pcGatewayMacs),
	uintptr(pdwFlags),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL

function ReadGuidsForConnectedNetworks(
  pcNetworks: Pointer;   // DWORD* optional, out
  pppwszNetworkGuids: PPWideChar;   // LPWSTR** optional, out
  pppbstrNetworkNames: PPWideChar;   // LPWSTR** optional, out
  pppwszGWMacs: PPWideChar;   // LPWSTR** optional, out
  pcGatewayMacs: Pointer;   // DWORD* optional, out
  pdwFlags: Pointer   // DWORD* optional, out
): BOOL; stdcall;
  external 'WININET.dll' name 'ReadGuidsForConnectedNetworks';

result := DllCall("WININET\ReadGuidsForConnectedNetworks"
    , "Ptr", pcNetworks   ; DWORD* optional, out
    , "Ptr", pppwszNetworkGuids   ; LPWSTR** optional, out
    , "Ptr", pppbstrNetworkNames   ; LPWSTR** optional, out
    , "Ptr", pppwszGWMacs   ; LPWSTR** optional, out
    , "Ptr", pcGatewayMacs   ; DWORD* optional, out
    , "Ptr", pdwFlags   ; DWORD* optional, out
    , "Int")   ; return: BOOL

●ReadGuidsForConnectedNetworks(pcNetworks, pppwszNetworkGuids, pppbstrNetworkNames, pppwszGWMacs, pcGatewayMacs, pdwFlags) = DLL("WININET.dll", "bool ReadGuidsForConnectedNetworks(void*, void*, void*, void*, void*, void*)")
# 呼び出し: ReadGuidsForConnectedNetworks(pcNetworks, pppwszNetworkGuids, pppbstrNetworkNames, pppwszGWMacs, pcGatewayMacs, pdwFlags)
# pcNetworks : DWORD* optional, out -> "void*"
# pppwszNetworkGuids : LPWSTR** optional, out -> "void*"
# pppbstrNetworkNames : LPWSTR** optional, out -> "void*"
# pppwszGWMacs : LPWSTR** optional, out -> "void*"
# pcGatewayMacs : DWORD* optional, out -> "void*"
# pdwFlags : DWORD* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。