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

WlanHostedNetworkSetSecondaryKey

関数
ホストネットワークのセカンダリセキュリティキーを設定する。
DLLwlanapi.dll呼出規約winapi対応OSWindows 7 以降
📘 Microsoft Learn (日本語) · English

シグネチャ

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

DWORD WlanHostedNetworkSetSecondaryKey(
    HANDLE hClientHandle,
    DWORD dwKeyLength,
    BYTE* pucKeyData,
    BOOL bIsPassPhrase,
    BOOL bPersistent,
    WLAN_HOSTED_NETWORK_REASON* pFailReason,   // optional
    void* pvReserved   // optional
);

パラメーター

名前型方向説明
hClientHandleHANDLEinクライアントのセッションハンドル。以前に WlanOpenHandle 関数を呼び出したときに返された値です。
dwKeyLengthDWORDinpucKeyData パラメーターが指すキーデータ配列内の有効なデータのバイト数。キーがパスフレーズの場合、このキー長には終端の ‘\0’ を含める必要があります。
pucKeyDataBYTE*inキーデータを格納するバッファーへのポインター。バッファー内の有効なデータのバイト数は、少なくとも dwKeyLength パラメーターで指定された値でなければなりません。
bIsPassPhraseBOOLin

pucKeyData パラメーターが指すキーデータ配列がパスフレーズ形式かどうかを示すブール値。

このパラメーターが TRUE の場合、キーデータ配列はパスフレーズ形式です。このパラメーターが FALSE の場合、キーデータ配列はパスフレーズ形式ではありません。

bPersistentBOOLin

pucKeyData パラメーターが指すキーデータ配列を保存して後で再利用するか、1 回限りの使用とするかを示すブール値。

このパラメーターが TRUE の場合、キーデータ配列は保存されて後で再利用されます。このパラメーターが FALSE の場合、キーデータ配列は 1 つのセッション (現在のセッション、または Hosted Network が開始されていない場合は次のセッション) でのみ使用されます。

pFailReasonWLAN_HOSTED_NETWORK_REASON*outoptionalWlanHostedNetworkSetSecondaryKey 関数の呼び出しが失敗した場合に、失敗の理由を受け取る値への省略可能なポインター。失敗の理由として指定できる値は、Wlanapi.h ヘッダーファイルで定義されている WLAN_HOSTED_NETWORK_REASON 列挙型の値です。
pvReservedvoid*optional将来の使用のために予約されています。このパラメーターは NULL でなければなりません。

戻り値の型: DWORD

公式ドキュメント

ワイヤレス Hosted Network が使用するセカンダリセキュリティキーを構成します。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

戻り値 説明
ERROR_INVALID_HANDLE
 ハンドルが無効です。このエラーは、hClientHandle パラメーターで指定されたハンドルがハンドルテーブルに見つからなかった場合に返されます。
ERROR_INVALID_PARAMETER
 パラメーターが正しくありません。このエラーは、次のいずれかの状況が発生した場合に返されます。
  • hClientHandle が NULL である。
  • pucKeyData が NULL である。
  • pucKeyData が適切な形式の有効なキーを指していない。
  • pvReserved が NULL ではない。
ERROR_INVALID_STATE
 リソースが、要求された操作を実行できる正しい状態にありません。これは、ワイヤレス Hosted Network がシャットダウン処理中である場合に発生することがあります。
ERROR_SERVICE_NOT_ACTIVE
 サービスが開始されていません。このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。
その他
 さまざまな RPC エラーコードやその他のエラーコード。返されたエラーに対応するメッセージ文字列を取得するには、 FormatMessage を使用します。

解説(Remarks)

WlanHostedNetworkSetSecondaryKey 関数は、Windows 7 および Wireless LAN Service がインストールされた Windows Server 2008 R2 でワイヤレス Hosted Network をサポートするために追加された、ネイティブワイヤレス API の拡張機能です。

クライアントアプリケーションは、ワイヤレス Hosted Network が使用するセカンダリセキュリティキーを構成するために WlanHostedNetworkSetSecondaryKey 関数を呼び出します。 この関数によって生じた Hosted Network の変更は、呼び出し元アプリケーションが呼び出しに使用したハンドルを閉じた場合 (hClientHandle パラメーターを指定して WlanCloseHandle を呼び出した場合) や、プロセスが終了した場合でも、自動的には元に戻されません。

ワイヤレス Hosted Network は、いったん開始されると、プライマリセキュリティキーに加えて、このセカンダリセキュリティキーを使用してワイヤレスピアが関連付けを行うことを許可します。セカンダリセキュリティキーは常に必要に応じてユーザーが指定しますが、プライマリセキュリティキーはより高い安全性を備えた形でオペレーティングシステムによって生成されます。

pucKeyData パラメーターが指すバッファーで渡されるセカンダリセキュリティキーは WPA2-Personal 認証で使用され、次のいずれかの形式である必要があります。

有効なセカンダリセキュリティキーを構成するには、dwKeyLength パラメーターが正しい範囲内であり、かつ pucKeyData パラメーターが指定されたバイト数のデータを格納する有効なメモリバッファーを指している必要があります。現在構成されているセカンダリセキュリティキーをシステムから削除するには、アプリケーションは dwKeyLength パラメーターに 0 を、pucKeyData パラメーターに NULL を指定して WlanHostedNetworkSetSecondaryKey 関数を呼び出します。

pucKeyData パラメーターが NULL であるにもかかわらず dwKeyLength パラメーターが 0 でない場合、WlanHostedNetworkSetSecondaryKey 関数は ERROR_INVALID_PARAMETER を返します。同様に、dwKeyLength パラメーターが 0 であるにもかかわらず pucKeyData パラメーターが NULL でない場合も、WlanHostedNetworkSetSecondaryKey 関数は ERROR_INVALID_PARAMETER を返します。

セカンダリセキュリティキーは通常、ワイヤレス Hosted Network を開始する前に設定します。設定したキーは、次に Hosted Network が開始されたときに使用されます。

セカンダリセキュリティキーは、Hosted Network の開始後に設定することもできます。この場合、セカンダリセキュリティキーは直ちに使用されます。以前のセカンダリセキュリティキーを使用しているクライアントは接続されたままですが、何らかの理由で切断された場合やワイヤレス Hosted Network が再起動された場合は、再接続できなくなります。

bPersistent パラメーターに TRUE を設定すると、セカンダリセキュリティキーを永続的なものとして指定できます。永続的として指定した場合、Hosted Network が既に開始されていればセカンダリセキュリティキーは直ちに使用され、さらに以後 Hosted Network が開始されるたびに再利用されます。

セカンダリセキュリティキーを永続的として指定しなかった場合、Hosted Network が既に開始されていれば直ちに使用され、そうでなければ次回 Hosted Network が開始されるときにのみ使用されます。Hosted Network が停止された後、このセカンダリセキュリティキーが再び使用されることはなく、システムから削除されます。

Hosted Network で使用するセカンダリセキュリティキーを構成するために、この関数はどのユーザーでも呼び出すことができます。ただし、ワイヤレス Hosted Network を有効にする権限は、ドメインではグループポリシーによって制限される場合があります。

Windows 7 以降では、Hosted Network に対応したワイヤレスアダプターがコンピューターに存在する場合、オペレーティングシステムは仮想デバイスをインストールします。コンピューターにワイヤレスネットワークアダプターが 1 つだけある場合、この仮想デバイスは通常「ネットワーク接続フォルダー」に、デバイス名が「Microsoft Virtual WiFi Miniport adapter」の「ワイヤレス ネットワーク接続 2」として表示されます。この仮想デバイスはソフトウェアアクセスポイント (SoftAP) 接続を行うためだけに使用され、WlanEnumInterfaces 関数が返す一覧には含まれません。この仮想デバイスの有効期間は物理ワイヤレスアダプターに連動します。物理ワイヤレスアダプターが無効化されると、この仮想デバイスも削除されます。この機能は、Wireless LAN Service がインストールされた Windows Server 2008 R2 でも利用できます。

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

各言語での呼び出し定義

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

DWORD WlanHostedNetworkSetSecondaryKey(
    HANDLE hClientHandle,
    DWORD dwKeyLength,
    BYTE* pucKeyData,
    BOOL bIsPassPhrase,
    BOOL bPersistent,
    WLAN_HOSTED_NETWORK_REASON* pFailReason,   // optional
    void* pvReserved   // optional
);
[DllImport("wlanapi.dll", ExactSpelling = true)]
static extern uint WlanHostedNetworkSetSecondaryKey(
    IntPtr hClientHandle,   // HANDLE
    uint dwKeyLength,   // DWORD
    IntPtr pucKeyData,   // BYTE*
    bool bIsPassPhrase,   // BOOL
    bool bPersistent,   // BOOL
    IntPtr pFailReason,   // WLAN_HOSTED_NETWORK_REASON* optional, out
    IntPtr pvReserved   // void* optional
);
<DllImport("wlanapi.dll", ExactSpelling:=True)>
Public Shared Function WlanHostedNetworkSetSecondaryKey(
    hClientHandle As IntPtr,   ' HANDLE
    dwKeyLength As UInteger,   ' DWORD
    pucKeyData As IntPtr,   ' BYTE*
    bIsPassPhrase As Boolean,   ' BOOL
    bPersistent As Boolean,   ' BOOL
    pFailReason As IntPtr,   ' WLAN_HOSTED_NETWORK_REASON* optional, out
    pvReserved As IntPtr   ' void* optional
) As UInteger
End Function
' hClientHandle : HANDLE
' dwKeyLength : DWORD
' pucKeyData : BYTE*
' bIsPassPhrase : BOOL
' bPersistent : BOOL
' pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
' pvReserved : void* optional
Declare PtrSafe Function WlanHostedNetworkSetSecondaryKey Lib "wlanapi" ( _
    ByVal hClientHandle As LongPtr, _
    ByVal dwKeyLength As Long, _
    ByVal pucKeyData As LongPtr, _
    ByVal bIsPassPhrase As Long, _
    ByVal bPersistent 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

WlanHostedNetworkSetSecondaryKey = ctypes.windll.wlanapi.WlanHostedNetworkSetSecondaryKey
WlanHostedNetworkSetSecondaryKey.restype = wintypes.DWORD
WlanHostedNetworkSetSecondaryKey.argtypes = [
    wintypes.HANDLE,  # hClientHandle : HANDLE
    wintypes.DWORD,  # dwKeyLength : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # pucKeyData : BYTE*
    wintypes.BOOL,  # bIsPassPhrase : BOOL
    wintypes.BOOL,  # bPersistent : BOOL
    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')
WlanHostedNetworkSetSecondaryKey = Fiddle::Function.new(
  lib['WlanHostedNetworkSetSecondaryKey'],
  [
    Fiddle::TYPE_VOIDP,  # hClientHandle : HANDLE
    -Fiddle::TYPE_INT,  # dwKeyLength : DWORD
    Fiddle::TYPE_VOIDP,  # pucKeyData : BYTE*
    Fiddle::TYPE_INT,  # bIsPassPhrase : BOOL
    Fiddle::TYPE_INT,  # bPersistent : BOOL
    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 WlanHostedNetworkSetSecondaryKey(
        hClientHandle: *mut core::ffi::c_void,  // HANDLE
        dwKeyLength: u32,  // DWORD
        pucKeyData: *mut u8,  // BYTE*
        bIsPassPhrase: i32,  // BOOL
        bPersistent: i32,  // BOOL
        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 WlanHostedNetworkSetSecondaryKey(IntPtr hClientHandle, uint dwKeyLength, IntPtr pucKeyData, bool bIsPassPhrase, bool bPersistent, IntPtr pFailReason, IntPtr pvReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'wlanapi_WlanHostedNetworkSetSecondaryKey' -Namespace Win32 -PassThru
# $api::WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
#uselib "wlanapi.dll"
#func global WlanHostedNetworkSetSecondaryKey "WlanHostedNetworkSetSecondaryKey" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WlanHostedNetworkSetSecondaryKey hClientHandle, dwKeyLength, varptr(pucKeyData), bIsPassPhrase, bPersistent, varptr(pFailReason), pvReserved   ; 戻り値は stat
; hClientHandle : HANDLE -> "sptr"
; dwKeyLength : DWORD -> "sptr"
; pucKeyData : BYTE* -> "sptr"
; bIsPassPhrase : BOOL -> "sptr"
; bPersistent : BOOL -> "sptr"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "sptr"
; pvReserved : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数: 
#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkSetSecondaryKey "WlanHostedNetworkSetSecondaryKey" sptr, int, var, int, int, var, sptr
; res = WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "sptr"
; dwKeyLength : DWORD -> "int"
; pucKeyData : BYTE* -> "var"
; bIsPassPhrase : BOOL -> "int"
; bPersistent : BOOL -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "var"
; pvReserved : void* optional -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数: 
; DWORD WlanHostedNetworkSetSecondaryKey(HANDLE hClientHandle, DWORD dwKeyLength, BYTE* pucKeyData, BOOL bIsPassPhrase, BOOL bPersistent, WLAN_HOSTED_NETWORK_REASON* pFailReason, void* pvReserved)
#uselib "wlanapi.dll"
#cfunc global WlanHostedNetworkSetSecondaryKey "WlanHostedNetworkSetSecondaryKey" intptr, int, var, int, int, var, intptr
; res = WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
; hClientHandle : HANDLE -> "intptr"
; dwKeyLength : DWORD -> "int"
; pucKeyData : BYTE* -> "var"
; bIsPassPhrase : BOOL -> "int"
; bPersistent : BOOL -> "int"
; pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "var"
; pvReserved : void* optional -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	wlanapi = windows.NewLazySystemDLL("wlanapi.dll")
	procWlanHostedNetworkSetSecondaryKey = wlanapi.NewProc("WlanHostedNetworkSetSecondaryKey")
)

// hClientHandle (HANDLE), dwKeyLength (DWORD), pucKeyData (BYTE*), bIsPassPhrase (BOOL), bPersistent (BOOL), pFailReason (WLAN_HOSTED_NETWORK_REASON* optional, out), pvReserved (void* optional)
r1, _, err := procWlanHostedNetworkSetSecondaryKey.Call(
	uintptr(hClientHandle),
	uintptr(dwKeyLength),
	uintptr(pucKeyData),
	uintptr(bIsPassPhrase),
	uintptr(bPersistent),
	uintptr(pFailReason),
	uintptr(pvReserved),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function WlanHostedNetworkSetSecondaryKey(
  hClientHandle: THandle;   // HANDLE
  dwKeyLength: DWORD;   // DWORD
  pucKeyData: Pointer;   // BYTE*
  bIsPassPhrase: BOOL;   // BOOL
  bPersistent: BOOL;   // BOOL
  pFailReason: Pointer;   // WLAN_HOSTED_NETWORK_REASON* optional, out
  pvReserved: Pointer   // void* optional
): DWORD; stdcall;
  external 'wlanapi.dll' name 'WlanHostedNetworkSetSecondaryKey';
result := DllCall("wlanapi\WlanHostedNetworkSetSecondaryKey"
    , "Ptr", hClientHandle   ; HANDLE
    , "UInt", dwKeyLength   ; DWORD
    , "Ptr", pucKeyData   ; BYTE*
    , "Int", bIsPassPhrase   ; BOOL
    , "Int", bPersistent   ; BOOL
    , "Ptr", pFailReason   ; WLAN_HOSTED_NETWORK_REASON* optional, out
    , "Ptr", pvReserved   ; void* optional
    , "UInt")   ; return: DWORD
●WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved) = DLL("wlanapi.dll", "dword WlanHostedNetworkSetSecondaryKey(void*, dword, void*, bool, bool, void*, void*)")
# 呼び出し: WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
# hClientHandle : HANDLE -> "void*"
# dwKeyLength : DWORD -> "dword"
# pucKeyData : BYTE* -> "void*"
# bIsPassPhrase : BOOL -> "bool"
# bPersistent : BOOL -> "bool"
# pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "void*"
# pvReserved : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "wlanapi" fn WlanHostedNetworkSetSecondaryKey(
    hClientHandle: ?*anyopaque, // HANDLE
    dwKeyLength: u32, // DWORD
    pucKeyData: [*c]u8, // BYTE*
    bIsPassPhrase: i32, // BOOL
    bPersistent: i32, // BOOL
    pFailReason: [*c]i32, // WLAN_HOSTED_NETWORK_REASON* optional, out
    pvReserved: ?*anyopaque // void* optional
) callconv(std.os.windows.WINAPI) u32;
proc WlanHostedNetworkSetSecondaryKey(
    hClientHandle: pointer,  # HANDLE
    dwKeyLength: uint32,  # DWORD
    pucKeyData: ptr uint8,  # BYTE*
    bIsPassPhrase: int32,  # BOOL
    bPersistent: int32,  # BOOL
    pFailReason: ptr int32,  # WLAN_HOSTED_NETWORK_REASON* optional, out
    pvReserved: pointer  # void* optional
): uint32 {.importc: "WlanHostedNetworkSetSecondaryKey", stdcall, dynlib: "wlanapi.dll".}
pragma(lib, "wlanapi");
extern(Windows)
uint WlanHostedNetworkSetSecondaryKey(
    void* hClientHandle,   // HANDLE
    uint dwKeyLength,   // DWORD
    ubyte* pucKeyData,   // BYTE*
    int bIsPassPhrase,   // BOOL
    int bPersistent,   // BOOL
    int* pFailReason,   // WLAN_HOSTED_NETWORK_REASON* optional, out
    void* pvReserved   // void* optional
);
ccall((:WlanHostedNetworkSetSecondaryKey, "wlanapi.dll"), stdcall, UInt32,
      (Ptr{Cvoid}, UInt32, Ptr{UInt8}, Int32, Int32, Ptr{Int32}, Ptr{Cvoid}),
      hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
# hClientHandle : HANDLE -> Ptr{Cvoid}
# dwKeyLength : DWORD -> UInt32
# pucKeyData : BYTE* -> Ptr{UInt8}
# bIsPassPhrase : BOOL -> Int32
# bPersistent : BOOL -> Int32
# pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> Ptr{Int32}
# pvReserved : void* optional -> Ptr{Cvoid}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
uint32_t WlanHostedNetworkSetSecondaryKey(
    void* hClientHandle,
    uint32_t dwKeyLength,
    uint8_t* pucKeyData,
    int32_t bIsPassPhrase,
    int32_t bPersistent,
    int32_t* pFailReason,
    void* pvReserved);
]]
local wlanapi = ffi.load("wlanapi")
-- wlanapi.WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
-- hClientHandle : HANDLE
-- dwKeyLength : DWORD
-- pucKeyData : BYTE*
-- bIsPassPhrase : BOOL
-- bPersistent : BOOL
-- pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
-- pvReserved : void* optional
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('wlanapi.dll');
const WlanHostedNetworkSetSecondaryKey = lib.func('__stdcall', 'WlanHostedNetworkSetSecondaryKey', 'uint32_t', ['void *', 'uint32_t', 'uint8_t *', 'int32_t', 'int32_t', 'int32_t *', 'void *']);
// WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
// hClientHandle : HANDLE -> 'void *'
// dwKeyLength : DWORD -> 'uint32_t'
// pucKeyData : BYTE* -> 'uint8_t *'
// bIsPassPhrase : BOOL -> 'int32_t'
// bPersistent : BOOL -> 'int32_t'
// pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> 'int32_t *'
// pvReserved : void* optional -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("wlanapi.dll", {
  WlanHostedNetworkSetSecondaryKey: { parameters: ["pointer", "u32", "pointer", "i32", "i32", "pointer", "pointer"], result: "u32" },
});
// lib.symbols.WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved)
// hClientHandle : HANDLE -> "pointer"
// dwKeyLength : DWORD -> "u32"
// pucKeyData : BYTE* -> "pointer"
// bIsPassPhrase : BOOL -> "i32"
// bPersistent : BOOL -> "i32"
// pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> "pointer"
// pvReserved : void* optional -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
uint32_t WlanHostedNetworkSetSecondaryKey(
    void* hClientHandle,
    uint32_t dwKeyLength,
    uint8_t* pucKeyData,
    int32_t bIsPassPhrase,
    int32_t bPersistent,
    int32_t* pFailReason,
    void* pvReserved);
C, "wlanapi.dll");
// $ffi->WlanHostedNetworkSetSecondaryKey(hClientHandle, dwKeyLength, pucKeyData, bIsPassPhrase, bPersistent, pFailReason, pvReserved);
// hClientHandle : HANDLE
// dwKeyLength : DWORD
// pucKeyData : BYTE*
// bIsPassPhrase : BOOL
// bPersistent : BOOL
// pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out
// pvReserved : void* optional
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Wlanapi extends StdCallLibrary {
    Wlanapi INSTANCE = Native.load("wlanapi", Wlanapi.class);
    int WlanHostedNetworkSetSecondaryKey(
        Pointer hClientHandle,   // HANDLE
        int dwKeyLength,   // DWORD
        byte[] pucKeyData,   // BYTE*
        boolean bIsPassPhrase,   // BOOL
        boolean bPersistent,   // BOOL
        IntByReference pFailReason,   // WLAN_HOSTED_NETWORK_REASON* optional, out
        Pointer pvReserved   // void* optional
    );
}
@[Link("wlanapi")]
lib Libwlanapi
  fun WlanHostedNetworkSetSecondaryKey = WlanHostedNetworkSetSecondaryKey(
    hClientHandle : Void*,   # HANDLE
    dwKeyLength : UInt32,   # DWORD
    pucKeyData : UInt8*,   # BYTE*
    bIsPassPhrase : Int32,   # BOOL
    bPersistent : Int32,   # BOOL
    pFailReason : Int32*,   # WLAN_HOSTED_NETWORK_REASON* optional, out
    pvReserved : Void*   # void* optional
  ) : UInt32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef WlanHostedNetworkSetSecondaryKeyNative = Uint32 Function(Pointer<Void>, Uint32, Pointer<Uint8>, Int32, Int32, Pointer<Int32>, Pointer<Void>);
typedef WlanHostedNetworkSetSecondaryKeyDart = int Function(Pointer<Void>, int, Pointer<Uint8>, int, int, Pointer<Int32>, Pointer<Void>);
final WlanHostedNetworkSetSecondaryKey = DynamicLibrary.open('wlanapi.dll')
    .lookupFunction<WlanHostedNetworkSetSecondaryKeyNative, WlanHostedNetworkSetSecondaryKeyDart>('WlanHostedNetworkSetSecondaryKey');
// hClientHandle : HANDLE -> Pointer<Void>
// dwKeyLength : DWORD -> Uint32
// pucKeyData : BYTE* -> Pointer<Uint8>
// bIsPassPhrase : BOOL -> Int32
// bPersistent : BOOL -> Int32
// pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> Pointer<Int32>
// pvReserved : void* optional -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function WlanHostedNetworkSetSecondaryKey(
  hClientHandle: THandle;   // HANDLE
  dwKeyLength: DWORD;   // DWORD
  pucKeyData: Pointer;   // BYTE*
  bIsPassPhrase: BOOL;   // BOOL
  bPersistent: BOOL;   // BOOL
  pFailReason: Pointer;   // WLAN_HOSTED_NETWORK_REASON* optional, out
  pvReserved: Pointer   // void* optional
): DWORD; stdcall;
  external 'wlanapi.dll' name 'WlanHostedNetworkSetSecondaryKey';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "WlanHostedNetworkSetSecondaryKey"
  c_WlanHostedNetworkSetSecondaryKey :: Ptr () -> Word32 -> Ptr Word8 -> CInt -> CInt -> Ptr Int32 -> Ptr () -> IO Word32
-- hClientHandle : HANDLE -> Ptr ()
-- dwKeyLength : DWORD -> Word32
-- pucKeyData : BYTE* -> Ptr Word8
-- bIsPassPhrase : BOOL -> CInt
-- bPersistent : BOOL -> CInt
-- pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> Ptr Int32
-- pvReserved : void* optional -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let wlanhostednetworksetsecondarykey =
  foreign "WlanHostedNetworkSetSecondaryKey"
    ((ptr void) @-> uint32_t @-> (ptr uint8_t) @-> int32_t @-> int32_t @-> (ptr int32_t) @-> (ptr void) @-> returning uint32_t)
(* hClientHandle : HANDLE -> (ptr void) *)
(* dwKeyLength : DWORD -> uint32_t *)
(* pucKeyData : BYTE* -> (ptr uint8_t) *)
(* bIsPassPhrase : BOOL -> int32_t *)
(* bPersistent : BOOL -> int32_t *)
(* pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> (ptr int32_t) *)
(* pvReserved : void* optional -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library wlanapi (t "wlanapi.dll"))
(cffi:use-foreign-library wlanapi)

(cffi:defcfun ("WlanHostedNetworkSetSecondaryKey" wlan-hosted-network-set-secondary-key :convention :stdcall) :uint32
  (h-client-handle :pointer)   ; HANDLE
  (dw-key-length :uint32)   ; DWORD
  (puc-key-data :pointer)   ; BYTE*
  (b-is-pass-phrase :int32)   ; BOOL
  (b-persistent :int32)   ; BOOL
  (p-fail-reason :pointer)   ; WLAN_HOSTED_NETWORK_REASON* optional, out
  (pv-reserved :pointer))   ; void* optional
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $WlanHostedNetworkSetSecondaryKey = Win32::API::More->new('wlanapi',
    'DWORD WlanHostedNetworkSetSecondaryKey(HANDLE hClientHandle, DWORD dwKeyLength, LPVOID pucKeyData, BOOL bIsPassPhrase, BOOL bPersistent, LPVOID pFailReason, LPVOID pvReserved)');
# my $ret = $WlanHostedNetworkSetSecondaryKey->Call($hClientHandle, $dwKeyLength, $pucKeyData, $bIsPassPhrase, $bPersistent, $pFailReason, $pvReserved);
# hClientHandle : HANDLE -> HANDLE
# dwKeyLength : DWORD -> DWORD
# pucKeyData : BYTE* -> LPVOID
# bIsPassPhrase : BOOL -> BOOL
# bPersistent : BOOL -> BOOL
# pFailReason : WLAN_HOSTED_NETWORK_REASON* optional, out -> LPVOID
# pvReserved : void* optional -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

公式の関連項目
使用する型