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

MBN_PROVIDER2

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

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

フィールド

フィールドサイズx64x86説明
providerMBN_PROVIDER32/16+0+0シングルキャリアの MBN_PROVIDER 構造体が格納されます。
cellularClassMBN_CELLULAR_CLASS4+32+16プロバイダーが使用するセルラー クラスを指定する MBN_CELLULAR_CLASS が格納されます。
signalStrengthDWORD4+36+20GetSignalStrength で定義されている、デバイスが受信した信号品質が格納されます。
signalErrorDWORD4+40+24GetSignalError で定義されている信号エラー率が格納されます。

公式ドキュメント

重要

Windows 10 バージョン 1803 以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間の Windows ランタイム API に置き換えられています。

MBN_PROVIDER2 構造体は、ネットワーク サービス プロバイダーを表します。この構造体は IMbnMultiCarrier インターフェイスのプロバイダー固有のメソッドの多くで使用され、マルチキャリアをサポートするために MBN_PROVIDER を拡張したものです。この拡張には各プロバイダーの信号強度が含まれており、ユーザーがどのプロバイダーに接続すべきかを判断するのに役立ちます。

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

各言語での定義

#include <windows.h>

// MBN_PROVIDER  (x64 32 / x86 16 バイト)
typedef struct MBN_PROVIDER {
    LPWSTR providerID;
    DWORD providerState;
    LPWSTR providerName;
    DWORD dataClass;
} MBN_PROVIDER;

// MBN_PROVIDER2  (x64 48 / x86 28 バイト)
typedef struct MBN_PROVIDER2 {
    MBN_PROVIDER provider;
    MBN_CELLULAR_CLASS cellularClass;
    DWORD signalStrength;
    DWORD signalError;
} MBN_PROVIDER2;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MBN_PROVIDER
{
    public IntPtr providerID;
    public uint providerState;
    public IntPtr providerName;
    public uint dataClass;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MBN_PROVIDER2
{
    public MBN_PROVIDER provider;
    public int cellularClass;
    public uint signalStrength;
    public uint signalError;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MBN_PROVIDER
    Public providerID As IntPtr
    Public providerState As UInteger
    Public providerName As IntPtr
    Public dataClass As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MBN_PROVIDER2
    Public provider As MBN_PROVIDER
    Public cellularClass As Integer
    Public signalStrength As UInteger
    Public signalError As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MBN_PROVIDER(ctypes.Structure):
    _fields_ = [
        ("providerID", ctypes.c_void_p),
        ("providerState", wintypes.DWORD),
        ("providerName", ctypes.c_void_p),
        ("dataClass", wintypes.DWORD),
    ]

class MBN_PROVIDER2(ctypes.Structure):
    _fields_ = [
        ("provider", MBN_PROVIDER),
        ("cellularClass", ctypes.c_int),
        ("signalStrength", wintypes.DWORD),
        ("signalError", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MBN_PROVIDER {
    pub providerID: *mut core::ffi::c_void,
    pub providerState: u32,
    pub providerName: *mut core::ffi::c_void,
    pub dataClass: u32,
}

#[repr(C)]
pub struct MBN_PROVIDER2 {
    pub provider: MBN_PROVIDER,
    pub cellularClass: i32,
    pub signalStrength: u32,
    pub signalError: u32,
}
import "golang.org/x/sys/windows"

type MBN_PROVIDER struct {
	providerID uintptr
	providerState uint32
	providerName uintptr
	dataClass uint32
}

type MBN_PROVIDER2 struct {
	provider MBN_PROVIDER
	cellularClass int32
	signalStrength uint32
	signalError uint32
}
type
  MBN_PROVIDER = record
    providerID: Pointer;
    providerState: DWORD;
    providerName: Pointer;
    dataClass: DWORD;
  end;

  MBN_PROVIDER2 = record
    provider: MBN_PROVIDER;
    cellularClass: Integer;
    signalStrength: DWORD;
    signalError: DWORD;
  end;
const MBN_PROVIDER = extern struct {
    providerID: ?*anyopaque,
    providerState: u32,
    providerName: ?*anyopaque,
    dataClass: u32,
};

const MBN_PROVIDER2 = extern struct {
    provider: MBN_PROVIDER,
    cellularClass: i32,
    signalStrength: u32,
    signalError: u32,
};
type
  MBN_PROVIDER {.bycopy.} = object
    providerID: pointer
    providerState: uint32
    providerName: pointer
    dataClass: uint32

  MBN_PROVIDER2 {.bycopy.} = object
    provider: MBN_PROVIDER
    cellularClass: int32
    signalStrength: uint32
    signalError: uint32
struct MBN_PROVIDER
{
    void* providerID;
    uint providerState;
    void* providerName;
    uint dataClass;
}

struct MBN_PROVIDER2
{
    MBN_PROVIDER provider;
    int cellularClass;
    uint signalStrength;
    uint signalError;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; MBN_PROVIDER2 サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; provider : MBN_PROVIDER (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; cellularClass : MBN_CELLULAR_CLASS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; signalStrength : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; signalError : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MBN_PROVIDER2 サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; provider : MBN_PROVIDER (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; cellularClass : MBN_CELLULAR_CLASS (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; signalStrength : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; signalError : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global MBN_PROVIDER
    #field intptr providerID
    #field int providerState
    #field intptr providerName
    #field int dataClass
#endstruct

#defstruct global MBN_PROVIDER2
    #field MBN_PROVIDER provider
    #field int cellularClass
    #field int signalStrength
    #field int signalError
#endstruct

stdim st, MBN_PROVIDER2        ; NSTRUCT 変数を確保
st->cellularClass = 100
mes "cellularClass=" + st->cellularClass