Home » Windows API

InternetGetConnectedState

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


引用函式庫:
url


適用系統:
Internet Explorer 4.0以上


函式原型:

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



參數型態及說明:
pdwFlagsLong 本機電腦的連線旗標

說明
INTERNET_CONNECTION_CONFIGURED0x40 本機電腦有一個合法的連線,但目前可能尚未連線
INTERNET_CONNECTION_LAN0x02 本機電腦是透過區域網路方式連至網際網路
INTERNET_CONNECTION_MODEM0x01 本機電腦是使用數據機方式連至網際網路
INTERNET_CONNECTION_MODEM_BUSY0x08 數據機忙線中無法使用
INTERNET_CONNECTION_OFFLINE0x20 本機電腦目前處於離線狀態
INTERNET_CONNECTION_PROXY0x04 本機電腦透過代理伺服器方式連至網際網路

dwReservedLong 保留參數,此參數必須為 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範例:

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#範例:

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 參數來取得連線的旗標資料

發表迴響