W tym artykule „krok po kroku” opisano sposób testowania poleceniem ping zdalnego adresu Internet Protocol (IP) przy użyciu programu Visual Basic 6.0 i pliku Icmp.dll.
Użycie protokołu ICMP i polecenia ping w programie Visual Basic
Uruchom program Microsoft Visual Basic 6.0.
W oknie dialogowym New Project kliknij pozycję Standard EXE, a następnie kliknij przycisk Open. Zostanie otwarte okno edytora Visual Basic Design Editor zawierające formularz Form1.
Aby dodać nowy moduł do tego projektu, kliknij prawym przyciskiem myszy pozycję Project1.vbp w oknie Project Explorer, wskaż polecenie Add, a następnie kliknij polecenie Module.
W oknie dialogowym Add Module kliknij przycisk Open. Do projektu zostanie dodany moduł Module1.bas i otworzy się okno edytora kodu (Code Editor).
U góry okna edytora kodu dla modułu Module1 wprowadź następujące deklaracje stałych i funkcji:
Option Explicit
'Stałe Icmp konwertowane z
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/win32_pingstatus.asp
Private Const ICMP_SUCCESS As Long = 0
Private Const ICMP_STATUS_BUFFER_TO_SMALL = 11001 'Za mały bufor
Private Const ICMP_STATUS_DESTINATION_NET_UNREACH = 11002 'Sieć docelowa jest nieosiągalna
Private Const ICMP_STATUS_DESTINATION_HOST_UNREACH = 11003 'Host docelowy jest nieosiągalny
Private Const ICMP_STATUS_DESTINATION_PROTOCOL_UNREACH = 11004 'Protokół docelowy jest nieosiągalny
Private Const ICMP_STATUS_DESTINATION_PORT_UNREACH = 11005 'Port docelowy jest nieosiągalny
Private Const ICMP_STATUS_NO_RESOURCE = 11006 'Brak zasobów
Private Const ICMP_STATUS_BAD_OPTION = 11007 'Zła opcja
Private Const ICMP_STATUS_HARDWARE_ERROR = 11008 'Błąd sprzętowy
Private Const ICMP_STATUS_LARGE_PACKET = 11009 'Za duży pakiet
Private Const ICMP_STATUS_REQUEST_TIMED_OUT = 11010 'Upłynął limit czasu żądania
Private Const ICMP_STATUS_BAD_REQUEST = 11011 'Niewłaściwe żądanie
Private Const ICMP_STATUS_BAD_ROUTE = 11012 'Zła trasa
Private Const ICMP_STATUS_TTL_EXPIRED_TRANSIT = 11013 'Wygasły tranzyt licznika TimeToLive
Private Const ICMP_STATUS_TTL_EXPIRED_REASSEMBLY = 11014 'Wygasła ponowna asemblacja licznika TimeToLive
Private Const ICMP_STATUS_PARAMETER = 11015 'Problem z parametrem
Private Const ICMP_STATUS_SOURCE_QUENCH = 11016 'Wygaszenie źródła
Private Const ICMP_STATUS_OPTION_TOO_BIG = 11017 'Za duża opcja
Private Const ICMP_STATUS_BAD_DESTINATION = 11018 'Niewłaściwe przeznaczenie
Private Const ICMP_STATUS_NEGOTIATING_IPSEC = 11032 'Negocjowanie protokołu IPSEC
Private Const ICMP_STATUS_GENERAL_FAILURE = 11050 'Błąd ogólny
Public Const WINSOCK_ERROR = "Windows Sockets nie odpowiada poprawnie."
Public Const INADDR_NONE As Long = &HFFFFFFFF
Public Const WSA_SUCCESS = 0
Public Const WS_VERSION_REQD As Long = &H101
'Czyszczenie gniazd (sockets).
'http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154512
Private Declare Function WSACleanup Lib "WSOCK32.DLL" () As Long
'Otwieranie połączenia dla gniazda (socket).
'http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154512
Private Declare Function WSAStartup Lib "WSOCK32.DLL" (ByVal wVersionRequired As Long, lpWSADATA As WSADATA) As Long
'Tworzenie uchwytu dla wydawanych żądań protokołu Internet Control Message Protocol (ICMP).
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcesdkr/htm/_wcesdk_icmpcreatefile.asp
Private Declare Function IcmpCreateFile Lib "icmp.dll" () As Long
'Konwersja ciągu zawierającego adres Ipv4 na odpowiedni adres.
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/winsock/wsapiref_4esy.asp
Private Declare Function inet_addr Lib "WSOCK32.DLL" (ByVal cp As String) As Long
'Zamykanie uchwytu protokołu Internet Control Message Protocol (ICMP) otwartego przez funkcję IcmpCreateFile.
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcesdkr/htm/_wcesdk_icmpclosehandle.asp
Private Declare Function IcmpCloseHandle Lib "icmp.dll" (ByVal IcmpHandle As Long) As Long
'Informacje o implementacji Windows Sockets
'http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154512
Private Type WSADATA
wVersion As Integer
wHighVersion As Integer
szDescription(0 To 256) As Byte
szSystemStatus(0 To 128) As Byte
iMaxSockets As Long
iMaxUDPDG As Long
lpVendorInfo As Long
End Type
'Wysłanie wywołania zwrotnego (echo request) protokołu ICMP i zwrócenie jednej lub kilku odpowiedzi.
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcetcpip/htm/cerefIcmpSendEcho.asp
Private Declare Function IcmpSendEcho Lib "icmp.dll" _
(ByVal IcmpHandle As Long, _
ByVal DestinationAddress As Long, _
ByVal RequestData As String, _
ByVal RequestSize As Long, _
ByVal RequestOptions As Long, _
ReplyBuffer As ICMP_ECHO_REPLY, _
ByVal ReplySize As Long, _
ByVal Timeout As Long) As Long
'Struktura opisująca opcje zawarte w uchwycie pakietu IP.
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcetcpip/htm/cerefIP_OPTION_INFORMATION.asp
Private Type IP_OPTION_INFORMATION
Ttl As Byte
Tos As Byte
Flags As Byte
OptionsSize As Byte
OptionsData As Long
End Type
'Struktura opisująca dane zwracane w odpowiedzi na wywołanie zwrotne (echo request).
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wcesdkr/htm/_wcesdk_icmp_echo_reply.asp
Public Type ICMP_ECHO_REPLY
address As Long
Status As Long
RoundTripTime As Long
DataSize As Long
Reserved As Integer
ptrData As Long
Options As IP_OPTION_INFORMATION
Data As String * 250
End Type
'-- Pingowanie znakowej reprezentacji adresu IP.
' -- Zwracanie odpowiedzi.
' -- Zwracanie długiego kodu.
Public Function ping(sAddress As String, Reply As ICMP_ECHO_REPLY) As Long
Dim hIcmp As Long
Dim lAddress As Long
Dim lTimeOut As Long
Dim StringToSend As String
'Krótki ciąg danych do wysłania
StringToSend = "hello"
'Limit czasu odpowiedzi ICMP (ping)
lTimeOut = 1000 'ms
'Konwersja adresu na długą reprezentację.
lAddress = inet_addr(sAddress)
If (lAddress <> -1) And (lAddress <> 0) Then
'Utworzenie uchwytu dla żądań ICMP.
hIcmp = IcmpCreateFile()
If hIcmp Then
'Pingowanie docelowego adresu IP.
Call IcmpSendEcho(hIcmp, lAddress, StringToSend, Len(StringToSend), 0, Reply, Len(Reply), lTimeOut)
'Status odpowiedzi
ping = Reply.Status
'Zamykanie uchwytu Icmp.
IcmpCloseHandle hIcmp
Else
Debug.Print "błąd przy otwieraniu uchwytu icmp."
ping = -1
End If
Else
ping = -1
End If
End Function
'Czyszczenie gniazd (sockets).
'http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154512
Public Sub SocketsCleanup()
WSACleanup
End Sub
'Pobieranie gotowych gniazd.
'http://support.microsoft.com/default.aspx?scid=kb;EN-US;q154512
Public Function SocketsInitialize() As Boolean
Dim WSAD As WSADATA
SocketsInitialize = WSAStartup(WS_VERSION_REQD, WSAD) = ICMP_SUCCESS
End Function
'Konwersja odpowiedzi ping na komunikat łatwy do odczytania w oparciu o zmienne.
'Informacje o tych stałych można znaleźć w witrynie sieci Web firmy Microsoft:
'http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/win32_pingstatus.asp
Public Function EvaluatePingResponse(PingResponse As Long) As String
Select Case PingResponse
'Sukces
Case ICMP_SUCCESS: EvaluatePingResponse = "Sukces!"
'Błędy
Case ICMP_STATUS_BUFFER_TO_SMALL: EvaluatePingResponse = "Za mały bufor"
Case ICMP_STATUS_DESTINATION_NET_UNREACH: EvaluatePingResponse = "Sieć docelowa jest nieosiągalna"
Case ICMP_STATUS_DESTINATION_HOST_UNREACH: EvaluatePingResponse = "Host docelowy jest nieosiągalny"
Case ICMP_STATUS_DESTINATION_PROTOCOL_UNREACH: EvaluatePingResponse = "Protokół docelowy jest nieosiągalny"
Case ICMP_STATUS_DESTINATION_PORT_UNREACH: EvaluatePingResponse = "Port docelowy jest nieosiągalny"
Case ICMP_STATUS_NO_RESOURCE: EvaluatePingResponse = "Brak zasobów"
Case ICMP_STATUS_BAD_OPTION: EvaluatePingResponse = "Zła opcja"
Case ICMP_STATUS_HARDWARE_ERROR: EvaluatePingResponse = "Błąd sprzętowy"
Case ICMP_STATUS_LARGE_PACKET: EvaluatePingResponse = "Za duży pakiet"
Case ICMP_STATUS_REQUEST_TIMED_OUT: EvaluatePingResponse = "Upłynął limit czasu żądania"
Case ICMP_STATUS_BAD_REQUEST: EvaluatePingResponse = "Niewłaściwe żądanie"
Case ICMP_STATUS_BAD_ROUTE: EvaluatePingResponse = "Zła trasa"
Case ICMP_STATUS_TTL_EXPIRED_TRANSIT: EvaluatePingResponse = "Wygasły tranzyt licznika TimeToLive"
Case ICMP_STATUS_TTL_EXPIRED_REASSEMBLY: EvaluatePingResponse = "Wygasła ponowna asemblacja licznika TimeToLive"
Case ICMP_STATUS_PARAMETER: EvaluatePingResponse = "Problem z parametrem"
Case ICMP_STATUS_SOURCE_QUENCH: EvaluatePingResponse = "Wygaszenie źródła"
Case ICMP_STATUS_OPTION_TOO_BIG: EvaluatePingResponse = "Za duża opcja"
Case ICMP_STATUS_BAD_DESTINATION: EvaluatePingResponse = "Niewłaściwe przeznaczenie"
Case ICMP_STATUS_NEGOTIATING_IPSEC: EvaluatePingResponse = "Negocjowanie protokołu IPSEC"
Case ICMP_STATUS_GENERAL_FAILURE: EvaluatePingResponse = "Błąd ogólny"
'Wystąpił nieznany błąd
Case Else: EvaluatePingResponse = "Nieznany błąd"
End Select
End Function
UWAGA: Należy zwrócić uwagę na miejsca łamania wierszy przy kopiowaniu kodu do projektu. Przedstawiony fragment kodu zawiera funkcje zapewniające dostęp do pliku Icmp.dll. Przejrzyj komentarze będące opisem stałych, deklaracji i wywołań funkcji.
W Eksploratorze projektu (Project Explorer) kliknij prawym przyciskiem myszy pozycję Form1, a następnie kliknij polecenie View Object. Formularz Form1 pojawi się w oknie projektowania (Designer).
Kliknij dwukrotnie zawartość formularza Form1. Otworzy się okno edytora kodu (Code Editor) zawierające następujący kod:
Private Sub Form_Load()
End Sub
Zastąp kod w metodzie Form_Load następującym fragmentem kodu:
Private Sub Form_Load()
Dim Reply As ICMP_ECHO_REPLY
Dim lngSuccess As Long
Dim strIPAddress As String
'Pobranie gotowych gniazd (sockets).
If SocketsInitialize() Then
'Pingowany adres
strIPAddress = "192.168.1.1"
'Pingowanie adresu IP i uzyskiwanie odpowiedzi.
lngSuccess = ping(strIPAddress, Reply)
'Wyświetlenie wyników.
Debug.Print "Pingowany adres IP: " & strIPAddress
Debug.Print "Kod ICMP: " & lngSuccess
Debug.Print "Komunikat odpowiedzi: " & EvaluatePingResponse(lngSuccess)
Debug.Print "Czas: " & Reply.RoundTripTime & " ms"
'Czyszczenie gniazd (sockets).
SocketsCleanup
Else
'Błąd Winsock error, inicjowanie gniazd.
Debug.Print WINSOCK_ERROR
End If
End Sub
Znajdź następujące wiersze kodu:
'Pingowany adres IP
strIPAddress = "192.168.1.1"
Zmień strIPAddress na adres IP, dla którego chcesz wysłać polecenie ping.
Aby zapisać projekt i pliki powiązane z projektem, kliknij polecenie Save Project w menu File.
Wyniki działania programu są zapisywane w oknie Immediate. Aby sprawdzić, czy okno Immediate jest otwarte, kliknij polecenie Immediate Window w menu View.
Aby przetestować kod, naciśnij klawisz F5. Wyniki pojawią się w oknie Immediate. Wyniki będą mieć następujący format:
Pingowany adres IP: 192.168.1.1
Kod ICMP: 0
Komunikat odpowiedzi: Sukces!
Czas: 10 ms
UWAGA: Aby wysłać polecenie ping dla nazwy domeny, należy najpierw zamienić nazwę domeny na adres IP.
Aby uzyskać dodatkowe informacje, kliknij numer artykułu poniżej w celu wyświetlenia tego artykułu z bazy wiedzy Microsoft Knowledge Base:
154512
(http://support.microsoft.com/kb/154512/PL/
)
SAMPLE: Winsock.exe Getting HostAddress Using Windows Sockets
Help and Support
Powrót na górę
