ホーム › NetworkManagement.WiFi › WlanHostedNetworkQuerySecondaryKey

WlanHostedNetworkQuerySecondaryKey

関数

ホストネットワークのセカンダリセキュリティキーを取得する。

DLLwlanapi.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

DWORD WlanHostedNetworkQuerySecondaryKey(
    HANDLE hClientHandle,
    DWORD* pdwKeyLength,
    BYTE** ppucKeyData,
    BOOL* pbIsPassPhrase,
    BOOL* pbPersistent,
    WLAN_HOSTED_NETWORK_REASON* pFailReason,   // optional
    void* pvReserved   // optional
);

パラメーター

名前	型	方向
hClientHandle	HANDLE	in
pdwKeyLength	DWORD*	out
ppucKeyData	BYTE**	out
pbIsPassPhrase	BOOL*	out
pbPersistent	BOOL*	out
pFailReason	WLAN_HOSTED_NETWORK_REASON*	outoptional
pvReserved	void*	optional

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD WlanHostedNetworkQuerySecondaryKey(
    HANDLE hClientHandle,
    DWORD* pdwKeyLength,
    BYTE** ppucKeyData,
    BOOL* pbIsPassPhrase,
    BOOL* pbPersistent,
    WLAN_HOSTED_NETWORK_REASON* pFailReason,   // optional
    void* pvReserved   // optional
);

[DllImport("wlanapi.dll", ExactSpelling = true)]
static extern uint WlanHostedNetworkQuerySecondaryKey(
    IntPtr hClientHandle,   // HANDLE
    out uint pdwKeyLength,   // DWORD* out
    IntPtr ppucKeyData,   // BYTE** out
    out int pbIsPassPhrase,   // BOOL* out
    out int pbPersistent,   // BOOL* out
    IntPtr pFailReason,   // WLAN_HOSTED_NETWORK_REASON* optional, out
    IntPtr pvReserved   // void* optional
);

<DllImport("wlanapi.dll", ExactSpelling:=True)>
Public Shared Function WlanHostedNetworkQuerySecondaryKey(
    hClientHandle As IntPtr,   ' HANDLE
    <Out> ByRef pdwKeyLength As UInteger,   ' DWORD* out
    ppucKeyData As IntPtr,   ' BYTE** out
    <Out> ByRef pbIsPassPhrase As Integer,   ' BOOL* out
    <Out> ByRef pbPersistent As Integer,   ' BOOL* out
    pFailReason As IntPtr,   ' WLAN_HOSTED_NETWORK_REASON* optional, out
    pvReserved As IntPtr   ' void* optional
) As UInteger
End Function

' hClientHandle : HANDLE
' pdwKeyLength : DWORD* out
' ppucKeyData : BYTE** out
' pbIsPassPhrase : BOOL* out
' pbPersistent : BOOL* out
' pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
' pvReserved : void* optional
Declare PtrSafe Function WlanHostedNetworkQuerySecondaryKey Lib "wlanapi" ( _
    ByVal hClientHandle As LongPtr, _
    ByRef pdwKeyLength As Long, _
    ByVal ppucKeyData As LongPtr, _
    ByRef pbIsPassPhrase As Long, _
    ByRef pbPersistent As Long, _
    ByVal pFailReason As LongPtr, _
    ByVal pvReserved As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WlanHostedNetworkQuerySecondaryKey = ctypes.windll.wlanapi.WlanHostedNetworkQuerySecondaryKey
WlanHostedNetworkQuerySecondaryKey.restype = wintypes.DWORD
WlanHostedNetworkQuerySecondaryKey.argtypes = [
    wintypes.HANDLE,  # hClientHandle : HANDLE
    ctypes.POINTER(wintypes.DWORD),  # pdwKeyLength : DWORD* out
    ctypes.c_void_p,  # ppucKeyData : BYTE** out
    ctypes.c_void_p,  # pbIsPassPhrase : BOOL* out
    ctypes.c_void_p,  # pbPersistent : BOOL* out
    ctypes.c_void_p,  # pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
    ctypes.POINTER(None),  # pvReserved : void* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('wlanapi.dll')
WlanHostedNetworkQuerySecondaryKey = Fiddle::Function.new(
  lib['WlanHostedNetworkQuerySecondaryKey'],
  [
    Fiddle::TYPE_VOIDP,  # hClientHandle : HANDLE
    Fiddle::TYPE_VOIDP,  # pdwKeyLength : DWORD* out
    Fiddle::TYPE_VOIDP,  # ppucKeyData : BYTE** out
    Fiddle::TYPE_VOIDP,  # pbIsPassPhrase : BOOL* out
    Fiddle::TYPE_VOIDP,  # pbPersistent : BOOL* out
    Fiddle::TYPE_VOIDP,  # pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
    Fiddle::TYPE_VOIDP,  # pvReserved : void* optional
  ],
  -Fiddle::TYPE_INT)

#[link(name = "wlanapi")]
extern "system" {
    fn WlanHostedNetworkQuerySecondaryKey(
        hClientHandle: *mut core::ffi::c_void,  // HANDLE
        pdwKeyLength: *mut u32,  // DWORD* out
        ppucKeyData: *mut *mut u8,  // BYTE** out
        pbIsPassPhrase: *mut i32,  // BOOL* out
        pbPersistent: *mut i32,  // BOOL* out
        pFailReason: *mut i32,  // WLAN_HOSTED_NETWORK_REASON* optional, out
        pvReserved: *mut ()  // void* optional
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("wlanapi.dll")]
public static extern uint WlanHostedNetworkQuerySecondaryKey(IntPtr hClientHandle, out uint pdwKeyLength, IntPtr ppucKeyData, out int pbIsPassPhrase, out int pbPersistent, IntPtr pFailReason, IntPtr pvReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'wlanapi_WlanHostedNetworkQuerySecondaryKey' -Namespace Win32 -PassThru
# $api::WlanHostedNetworkQuerySecondaryKey(hClientHandle, pdwKeyLength, ppucKeyData, pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)

#uselib "wlanapi.dll"
#func global WlanHostedNetworkQuerySecondaryKey "WlanHostedNetworkQuerySecondaryKey" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WlanHostedNetworkQuerySecondaryKey hClientHandle, varptr(pdwKeyLength), varptr(ppucKeyData), pbIsPassPhrase, pbPersistent, pFailReason, pvReserved   ; 戻り値は stat
; hClientHandle : HANDLE -> "sptr"
; pdwKeyLength : DWORD* out -> "sptr"
; ppucKeyData : BYTE** out -> "sptr"
; pbIsPassPhrase : BOOL* out -> "sptr"
; pbPersistent : BOOL* out -> "sptr"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "sptr"
; pvReserved : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkQuerySecondaryKey "WlanHostedNetworkQuerySecondaryKey" sptr, var, var, int, int, int, sptr
; res = WlanHostedNetworkQuerySecondaryKey(hClientHandle, pdwKeyLength, ppucKeyData, pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "sptr"
; pdwKeyLength : DWORD* out -> "var"
; ppucKeyData : BYTE** out -> "var"
; pbIsPassPhrase : BOOL* out -> "int"
; pbPersistent : BOOL* out -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "int"
; pvReserved : void* optional -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkQuerySecondaryKey "WlanHostedNetworkQuerySecondaryKey" sptr, sptr, sptr, int, int, int, sptr
; res = WlanHostedNetworkQuerySecondaryKey(hClientHandle, varptr(pdwKeyLength), varptr(ppucKeyData), pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "sptr"
; pdwKeyLength : DWORD* out -> "sptr"
; ppucKeyData : BYTE** out -> "sptr"
; pbIsPassPhrase : BOOL* out -> "int"
; pbPersistent : BOOL* out -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "int"
; pvReserved : void* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; DWORD WlanHostedNetworkQuerySecondaryKey(HANDLE hClientHandle, DWORD* pdwKeyLength, BYTE** ppucKeyData, BOOL* pbIsPassPhrase, BOOL* pbPersistent, WLAN_HOSTED_NETWORK_REASON* pFailReason, void* pvReserved)
#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkQuerySecondaryKey "WlanHostedNetworkQuerySecondaryKey" intptr, var, var, int, int, int, intptr
; res = WlanHostedNetworkQuerySecondaryKey(hClientHandle, pdwKeyLength, ppucKeyData, pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "intptr"
; pdwKeyLength : DWORD* out -> "var"
; ppucKeyData : BYTE** out -> "var"
; pbIsPassPhrase : BOOL* out -> "int"
; pbPersistent : BOOL* out -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "int"
; pvReserved : void* optional -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD WlanHostedNetworkQuerySecondaryKey(HANDLE hClientHandle, DWORD* pdwKeyLength, BYTE** ppucKeyData, BOOL* pbIsPassPhrase, BOOL* pbPersistent, WLAN_HOSTED_NETWORK_REASON* pFailReason, void* pvReserved)
#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkQuerySecondaryKey "WlanHostedNetworkQuerySecondaryKey" intptr, intptr, intptr, int, int, int, intptr
; res = WlanHostedNetworkQuerySecondaryKey(hClientHandle, varptr(pdwKeyLength), varptr(ppucKeyData), pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "intptr"
; pdwKeyLength : DWORD* out -> "intptr"
; ppucKeyData : BYTE** out -> "intptr"
; pbIsPassPhrase : BOOL* out -> "int"
; pbPersistent : BOOL* out -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "int"
; pvReserved : void* optional -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	wlanapi = windows.NewLazySystemDLL("wlanapi.dll")
	procWlanHostedNetworkQuerySecondaryKey = wlanapi.NewProc("WlanHostedNetworkQuerySecondaryKey")
)

// hClientHandle (HANDLE), pdwKeyLength (DWORD* out), ppucKeyData (BYTE** out), pbIsPassPhrase (BOOL* out), pbPersistent (BOOL* out), pFailReason (WLAN_HOSTED_NETWORK_REASON* optional, out), pvReserved (void* optional)
r1, _, err := procWlanHostedNetworkQuerySecondaryKey.Call(
	uintptr(hClientHandle),
	uintptr(pdwKeyLength),
	uintptr(ppucKeyData),
	uintptr(pbIsPassPhrase),
	uintptr(pbPersistent),
	uintptr(pFailReason),
	uintptr(pvReserved),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function WlanHostedNetworkQuerySecondaryKey(
  hClientHandle: THandle;   // HANDLE
  pdwKeyLength: Pointer;   // DWORD* out
  ppucKeyData: Pointer;   // BYTE** out
  pbIsPassPhrase: Pointer;   // BOOL* out
  pbPersistent: Pointer;   // BOOL* out
  pFailReason: Pointer;   // WLAN_HOSTED_NETWORK_REASON* optional, out
  pvReserved: Pointer   // void* optional
): DWORD; stdcall;
  external 'wlanapi.dll' name 'WlanHostedNetworkQuerySecondaryKey';

result := DllCall("wlanapi\WlanHostedNetworkQuerySecondaryKey"
    , "Ptr", hClientHandle   ; HANDLE
    , "Ptr", pdwKeyLength   ; DWORD* out
    , "Ptr", ppucKeyData   ; BYTE** out
    , "Ptr", pbIsPassPhrase   ; BOOL* out
    , "Ptr", pbPersistent   ; BOOL* out
    , "Ptr", pFailReason   ; WLAN_HOSTED_NETWORK_REASON* optional, out
    , "Ptr", pvReserved   ; void* optional
    , "UInt")   ; return: DWORD

●WlanHostedNetworkQuerySecondaryKey(hClientHandle, pdwKeyLength, ppucKeyData, pbIsPassPhrase, pbPersistent, pFailReason, pvReserved) = DLL("wlanapi.dll", "dword WlanHostedNetworkQuerySecondaryKey(void*, void*, void*, void*, void*, void*, void*)")
# 呼び出し: WlanHostedNetworkQuerySecondaryKey(hClientHandle, pdwKeyLength, ppucKeyData, pbIsPassPhrase, pbPersistent, pFailReason, pvReserved)
# hClientHandle : HANDLE -> "void*"
# pdwKeyLength : DWORD* out -> "void*"
# ppucKeyData : BYTE** out -> "void*"
# pbIsPassPhrase : BOOL* out -> "void*"
# pbPersistent : BOOL* out -> "void*"
# pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "void*"
# pvReserved : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。