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

NETCONNECTINFOSTRUCT

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 20 バイト / x86: 20 バイト

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

フィールド

フィールド型サイズx64x86説明
cbStructureDWORD4+0+0NETCONNECTINFOSTRUCT 構造体のサイズ(バイト単位)。このフィールドは、渡される構造体のサイズを示すために呼び出し側が設定します。ネットワーク プロバイダーはこのフィールドを変更せず、構造体が dwOptDataSize までのすべてのフィールドを含むのに十分な大きさであると想定できます。
dwFlagsDWORD4+4+4

以下のフラグを 1 つ以上含むことができるビットマスクです。

値 意味
WNCON_FORNETCARD
 設定されている場合、返される情報は接続に使用されるネットワーク カードのパフォーマンスに関するものです。この情報は、実際の接続に関する情報が利用できない場合に返されます。

設定されていない場合、返される情報はリソースとの現在の接続に関するものであり、ルーティングによる性能低下も考慮されます。
WNCON_NOTROUTED
 設定されている場合、接続はルーティングされているものとして扱われません。つまり、パフォーマンスの推定時にルーティングは考慮されません。このため、実際のパフォーマンスは返される情報よりも大幅に低い場合があります。

設定されていない場合、接続はパフォーマンスを制限するルーターを経由している可能性があります。
WNCON_SLOWLINK
 設定されている場合、接続のどこかの区間が一般に低速な媒体(たとえば、通常品質の電話回線を使用するモデム)を経由していることが判明しています。

dwSpeed に値を返すプロバイダーは、このビットを設定する必要はありません。
WNCON_DYNAMIC
 設定されている場合、返される情報の一部は動的に再計算されます。その場合、この接続に対して要求を再発行すると、異なる、より新しい情報が返されることがあります。
dwSpeedDWORD4+8+8ネットワーク リソースへの媒体の速度(100bps 単位)。たとえば、1,200 ボーのポイント ツー ポイント リンクでは 12 が返されます。
dwDelayDWORD4+12+12情報の送信時にネットワークによって生じる遅延(ミリ秒単位)。つまり、ネットワークがデータの送信を開始してから受信されるまでの時間です。これは dwSpeed の計算に組み込まれている待ち時間に追加されるものであるため、ほとんどのリソースへのアクセスでは返される値は 0 になります。
dwOptDataSizeDWORD4+16+16アプリケーションがネットワーク リソースに対して 1 回の要求を行う際に、ネットワークを通じて最も効率よく送信できるデータ サイズ(バイト単位)の推奨値。たとえば、ディスク ネットワーク リソースの場合、データ ブロックの書き込み時にこの値は 2048 または 512 になることがあります。

公式ドキュメント

NETCONNECTINFOSTRUCT 構造体には、ネットワークのパフォーマンスに関する情報が含まれます。 NPGetConnectionPerformance 関数で使用されます。

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

各言語での定義

#include <windows.h>

// NETCONNECTINFOSTRUCT  (x64 20 / x86 20 バイト)
typedef struct NETCONNECTINFOSTRUCT {
    DWORD cbStructure;
    DWORD dwFlags;
    DWORD dwSpeed;
    DWORD dwDelay;
    DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct NETCONNECTINFOSTRUCT
{
    public uint cbStructure;
    public uint dwFlags;
    public uint dwSpeed;
    public uint dwDelay;
    public uint dwOptDataSize;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure NETCONNECTINFOSTRUCT
    Public cbStructure As UInteger
    Public dwFlags As UInteger
    Public dwSpeed As UInteger
    Public dwDelay As UInteger
    Public dwOptDataSize As UInteger
End Structure
import ctypes
from ctypes import wintypes

class NETCONNECTINFOSTRUCT(ctypes.Structure):
    _fields_ = [
        ("cbStructure", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("dwSpeed", wintypes.DWORD),
        ("dwDelay", wintypes.DWORD),
        ("dwOptDataSize", wintypes.DWORD),
    ]
#[repr(C)]
pub struct NETCONNECTINFOSTRUCT {
    pub cbStructure: u32,
    pub dwFlags: u32,
    pub dwSpeed: u32,
    pub dwDelay: u32,
    pub dwOptDataSize: u32,
}
import "golang.org/x/sys/windows"

type NETCONNECTINFOSTRUCT struct {
	cbStructure uint32
	dwFlags uint32
	dwSpeed uint32
	dwDelay uint32
	dwOptDataSize uint32
}
type
  NETCONNECTINFOSTRUCT = record
    cbStructure: DWORD;
    dwFlags: DWORD;
    dwSpeed: DWORD;
    dwDelay: DWORD;
    dwOptDataSize: DWORD;
  end;
const NETCONNECTINFOSTRUCT = extern struct {
    cbStructure: u32,
    dwFlags: u32,
    dwSpeed: u32,
    dwDelay: u32,
    dwOptDataSize: u32,
};
type
  NETCONNECTINFOSTRUCT {.bycopy.} = object
    cbStructure: uint32
    dwFlags: uint32
    dwSpeed: uint32
    dwDelay: uint32
    dwOptDataSize: uint32
struct NETCONNECTINFOSTRUCT
{
    uint cbStructure;
    uint dwFlags;
    uint dwSpeed;
    uint dwDelay;
    uint dwOptDataSize;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; NETCONNECTINFOSTRUCT サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; cbStructure : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwSpeed : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwDelay : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwOptDataSize : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global NETCONNECTINFOSTRUCT
    #field int cbStructure
    #field int dwFlags
    #field int dwSpeed
    #field int dwDelay
    #field int dwOptDataSize
#endstruct

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