Home » Windows API

InternetGetConnectedState

[ 日期： | 瀏覽：8,089 | 迴響：搶沙發 ]

說明：
InternetGetConnectedState 函式可判斷本機電腦目前的連線狀態

引用函式庫：
url

適用系統：
Internet Explorer 4.0以上

函式原型：

Declare Function InternetGetConnectedState Lib "url" Alias "InternetGetConnectedState" ( _
    ByRef lpdwFlags As Long, _
    ByVal dwReserved As Long _
    ) As Long



參數型態及說明：
pdwFlags：Long 本機電腦的連線旗標

值 說明
INTERNET_CONNECTION_CONFIGURED：0x40 本機電腦有一個合法的連線，但目前可能尚未連線
INTERNET_CONNECTION_LAN：0x02 本機電腦是透過區域網路方式連至網際網路
INTERNET_CONNECTION_MODEM：0x01 本機電腦是使用數據機方式連至網際網路
INTERNET_CONNECTION_MODEM_BUSY：0x08 數據機忙線中無法使用
INTERNET_CONNECTION_OFFLINE：0x20 本機電腦目前處於離線狀態
INTERNET_CONNECTION_PROXY：0x04 本機電腦透過代理伺服器方式連至網際網路

dwReserved：Long 保留參數，此參數必須為 0

回傳值：
Long 若系統為連線至網際網路狀態時，將會回傳 True；反之離線狀態時，則回傳 False

.NET Framework API：
My.Computer.Network.IsAvailable

VB範例：

檢視原始碼 Visual Basic
1
2
3
4
5
6
7
8
9
10
11
12
13

'VB的宣告
Private Declare Function InternetGetConnectedState Lib "wininet" ( _
	ByRef lpdwFlags As Long, _
	ByVal dwReserved As Long _
	) As Long
 
'連線的Flag
Dim flags As Long
 
Dim rtvl As Long
 
'取得本機電腦目前的連線狀態
rtvl = InternetGetConnectedState(flags, 0)

RB範例：

檢視原始碼 REALBasic
1
2
3
4
5
6
7
8
9
10
11
12
13

'RB的宣告
Declare Function InternetGetConnectedState Lib "wininet" ( _
	ByRef lpdwFlags As Integer, _
	dwReserved As Integer _
	) As Boolean
 
'連線的Flag
Dim flags As Integer
 
Dim rtvl As Boolean
 
'取得本機電腦目前的連線狀態
rtvl = InternetGetConnectedState(flags, 0)

VB.NET範例：

檢視原始碼 VB.NET
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

'VB.NET的宣告
<DllImport("wininet.dll")> _
Shared Function InternetGetConnectedState( _
	ByRef lpdwFlags As UInteger, _
	ByVal dwReserved As UInteger _
	) As Boolean
End Function
 
'連線的Flag
Dim flags As UInteger
 
Dim rtvl As Boolean
 
'取得本機電腦目前的連線狀態
rtvl = InternetGetConnectedState(flags, 0)

C#範例：

檢視原始碼 C#
1
2
3
4
5
6
7
8
9
10
11
12
13
14

//C#的宣告
[DllImport("wininet")]
public static extern bool InternetGetConnectedState(
	ref uint lpdwFlags, 
	uint dwReserved
	);
 
//連線的Flag
uint flags = 0x0;
 
bool rtvl;
 
//取得本機電腦目前的連線狀態
rtvl = InternetGetConnectedState(ref flags, 0);

註釋：
若要更詳細的資料，可透過 lpdwFlags 參數來取得連線的旗標資料。

發表迴響