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 CInternetConnection 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