Internet URL analizowania globalnych i pomocników

Gdy klient wysyła zapytanie do serwera internetowego, możesz użyć jednego z adresów URL do analizowania globalnych, aby wyodrębnić informacje o kliencie. Funkcje pomocnicze zapewniają inne funkcje internetowe.

Funkcje globalne do analizowania internetowych adresów URL

Nazwa/nazwisko	opis
AfxParseURL	Analizuje ciąg adresu URL i zwraca typ usługi i jej składniki.
AfxParseURLEx	Analizuje ciąg adresu URL i zwraca typ usługi i jej składników, a także podaje nazwę użytkownika i hasło.

Inni pomocnicy internetowi

Nazwa/nazwisko	opis
AfxThrowInternetException	Zgłasza wyjątek związany z połączeniem internetowym.
AfxGetInternetHandleType	Określa typ uchwytu internetowego.

AfxParseURL

Ten globalny jest używany w CInternetSession ::OpenURL.

BOOL AFXAPI AfxParseURL(
    LPCTSTR pstrURL,
    DWORD& dwServiceType,
    CString& strServer,
    CString& strObject,
    INTERNET_PORT& nPort);

Parametry

pstrURL
Wskaźnik do ciągu zawierającego adres URL, który ma zostać przeanalizowany.

dwServiceType
Wskazuje typ usługi internetowej. Dopuszczalne są następujące wartości:

• AFX_INET_SERVICE_FTP

• AFX_INET_SERVICE_HTTP

• AFX_INET_SERVICE_HTTPS

• AFX_INET_SERVICE_GOPHER

• AFX_INET_SERVICE_FILE

• AFX_INET_SERVICE_MAILTO

• AFX_INET_SERVICE_NEWS

• AFX_INET_SERVICE_NNTP

• AFX_INET_SERVICE_TELNET

• AFX_INET_SERVICE_WAIS

• AFX_INET_SERVICE_MID

• AFX_INET_SERVICE_CID

• AFX_INET_SERVICE_PROSPERO

• AFX_INET_SERVICE_AFS

• AFX_INET_SERVICE_UNK

strServer
Pierwszy segment adresu URL po typie usługi.

strObject
Obiekt, do którego odwołuje się adres URL (może być pusty).

Nport
Określana na podstawie części adresu URL serwera lub obiektu, jeśli istnieje.

Wartość zwracana

Nonzero, jeśli adres URL został pomyślnie przeanalizowany; w przeciwnym razie wartość 0, jeśli jest pusta lub nie zawiera znanego typu usługi internetowej.

Uwagi

Analizuje ciąg adresu URL i zwraca typ usługi i jego składniki.

Na przykład AfxParseURL analizuje adresy URL formularza service://server/dir/dir/object.ext:port i zwraca jego składniki przechowywane w następujący sposób:

strServer == "server"

strObject == "/dir/dir/object/object.ext"

nPort == #port

dwServiceType == #service

Uwaga

Aby wywołać tę funkcję, projekt musi zawierać element AFXINET.H.

Wymagania

Nagłówek afxinet.h

AfxParseURLEx

Ta funkcja globalna jest rozszerzoną wersją biblioteki AfxParseURL i jest używana w bibliotece CInternetSession::OpenURL.

BOOL AFXAPI AfxParseURLEx(
    LPCTSTR pstrURL,
    DWORD& dwServiceType,
    CString& strServer,
    CString& strObject,
    INTERNET_PORT& nPort,
    CString& strUsername,
    CString& strPassword,
    DWORD dwFlags = 0);

Parametry

pstrURL
Wskaźnik do ciągu zawierającego adres URL, który ma zostać przeanalizowany.

dwServiceType
Wskazuje typ usługi internetowej. Dopuszczalne są następujące wartości:

• AFX_INET_SERVICE_FTP

• AFX_INET_SERVICE_HTTP

• AFX_INET_SERVICE_HTTPS

• AFX_INET_SERVICE_GOPHER

• AFX_INET_SERVICE_FILE

• AFX_INET_SERVICE_MAILTO

• AFX_INET_SERVICE_NEWS

• AFX_INET_SERVICE_NNTP

• AFX_INET_SERVICE_TELNET

• AFX_INET_SERVICE_WAIS

• AFX_INET_SERVICE_MID

• AFX_INET_SERVICE_CID

• AFX_INET_SERVICE_PROSPERO

• AFX_INET_SERVICE_AFS

• AFX_INET_SERVICE_UNK

strServer
Pierwszy segment adresu URL po typie usługi.

strObject
Obiekt, do którego odwołuje się adres URL (może być pusty).

Nport
Określana na podstawie części adresu URL serwera lub obiektu, jeśli istnieje.

strUsername
Odwołanie do CString obiektu zawierającego nazwę użytkownika.

strPassword
Odwołanie do CString obiektu zawierającego hasło użytkownika.

Dwflags
Flagi kontrolujące sposób analizowania adresu URL. Może to być kombinacja następujących wartości:

Wartość	Znaczenie
ICU_DECODE	Przekonwertuj sekwencje ucieczki %XX na znaki.
ICU_NO_ENCODE	Nie konwertuj niebezpiecznych znaków na sekwencję ucieczki.
ICU_NO_META	Nie usuwaj sekwencji meta (takich jak "\ ." i "\ ..") z adresu URL.
ICU_ENCODE_SPACES_ONLY	Zakoduj tylko spacje.
ICU_BROWSER_MODE	Nie koduj ani nie dekoduj znaków po znaku "#" lub "" i nie usuwaj końcowego odstępu po znaku "". Jeśli ta wartość nie zostanie określona, cały adres URL zostanie zakodowany i usunięto końcowy biały znak.

Jeśli używasz wartości domyślnej MFC, która nie ma flag, funkcja konwertuje wszystkie niebezpieczne znaki i sekwencje meta (takie jak \.,\ .., i \...) na sekwencje ucieczki.

Wartość zwracana

Nonzero, jeśli adres URL został pomyślnie przeanalizowany; w przeciwnym razie wartość 0, jeśli jest pusta lub nie zawiera znanego typu usługi internetowej.

Uwagi

Analizuje ciąg adresu URL i zwraca typ usługi i jej składników, a także podaje nazwę użytkownika i hasło. Flagi wskazują sposób obsługi niebezpiecznych znaków.

Uwaga

Aby wywołać tę funkcję, projekt musi zawierać element AFXINET.H.

Wymagania

Nagłówek afxinet.h

AfxGetInternetHandleType

Ta funkcja globalna służy do określania typu dojścia do Internetu.

Składnia

DWORD AFXAPI AfxGetInternetHandleType(  HINTERNET hQuery );

Parametry

hQuery
Dojście do zapytania internetowego.

Wartość zwracana

Dowolny z typów usług internetowych zdefiniowanych przez WININET.H. Zapoznaj się z sekcją Uwagi, aby zapoznać się z listą tych usług internetowych. Jeśli dojście ma wartość NULL lub nie jest rozpoznawana, funkcja zwraca AFX_INET_SERVICE_UNK.

Uwagi

Poniższa lista zawiera możliwe typy internetowe zwracane przez AfxGetInternetHandleType.

• INTERNET_HANDLE_TYPE_INTERNET

• INTERNET_HANDLE_TYPE_CONNECT_FTP

• INTERNET_HANDLE_TYPE_CONNECT_GOPHER

• INTERNET_HANDLE_TYPE_CONNECT_HTTP

• INTERNET_HANDLE_TYPE_FTP_FIND

• INTERNET_HANDLE_TYPE_FTP_FIND_HTML

• INTERNET_HANDLE_TYPE_FTP_FILE

• INTERNET_HANDLE_TYPE_FTP_FILE_HTML

• INTERNET_HANDLE_TYPE_GOPHER_FIND

• INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

• INTERNET_HANDLE_TYPE_GOPHER_FILE

• INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

• INTERNET_HANDLE_TYPE_HTTP_REQUEST

Uwaga

Aby wywołać tę funkcję, projekt musi zawierać element AFXINET.H.

Wymagania

Nagłówek: afxinet.h

AfxThrowInternetException

Zgłasza wyjątek internetowy.

Składnia

   void AFXAPI AfxThrowInternetException(  DWORD dwContext,  DWORD dwError = 0 );

Parametry

Dwcontext
Identyfikator kontekstu operacji, która spowodowała błąd. Wartość domyślna dwContext jest określana pierwotnie w CInternetSession i jest przekazywana do klas pochodnych CInternet Połączenie ion- i CInternetFile. W przypadku określonych operacji wykonywanych na połączeniu lub pliku zwykle zastępujesz wartość domyślną wartością dwContext własnych. Następnie ta wartość jest zwracana do CInternetSession::OnStatusCallback w celu zidentyfikowania stanu określonej operacji.

dwError
Błąd, który spowodował wyjątek.

Uwagi

Odpowiadasz za określenie przyczyny na podstawie kodu błędu systemu operacyjnego.

Uwaga

Aby wywołać tę funkcję, projekt musi zawierać element AFXINET.H.

Wymagania

Nagłówek: afxinet.h

Zobacz też

Makra i globalne
Klasa CInternetException
AfxParseURL