Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Saat klien mengirim kueri ke server Internet, Anda dapat menggunakan salah satu URL yang mengurai global untuk mengekstrak informasi tentang klien. Fungsi pembantu menyediakan fungsionalitas internet lainnya.
Penguraian URL Internet Globals
| Nama | Deskripsi |
|---|---|
| AfxParseURL | Mengurai string URL dan mengembalikan jenis layanan dan komponennya. |
| AfxParseURLEx | Mengurai string URL dan mengembalikan jenis layanan dan komponennya, serta memberikan nama pengguna dan kata sandi. |
Pembantu Internet Lainnya
| Nama | Deskripsi |
|---|---|
| AfxThrowInternetException | Melempar pengecualian yang terkait dengan koneksi internet. |
| AfxGetInternetHandleType | Menentukan tipe handel Internet. |
AfxParseURL
Global ini digunakan dalam CInternetSession::OpenURL.
BOOL AFXAPI AfxParseURL(
LPCTSTR pstrURL,
DWORD& dwServiceType,
CString& strServer,
CString& strObject,
INTERNET_PORT& nPort);
Parameter
pstrURL
Penunjuk ke string yang berisi URL yang akan diurai.
dwServiceType
Menunjukkan jenis layanan Internet. Kemungkinan nilainya adalah sebagai berikut:
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
Segmen pertama URL mengikuti jenis layanan.
strObject
Objek yang dirujuk URL (mungkin kosong).
nPort
Ditentukan dari bagian Server atau Objek URL, jika ada.
Tampilkan Nilai
Bukan nol jika URL berhasil diurai; jika tidak, 0 jika kosong atau tidak berisi jenis layanan Internet yang diketahui.
Keterangan
Ini mengurai string URL dan mengembalikan jenis layanan dan komponennya.
Misalnya, AfxParseURL mengurai URL formulir service://server/dir/dir/object.ext:port dan mengembalikan komponennya yang disimpan sebagai berikut:
strServer == "server"
strObject == "/dir/dir/object/object.ext"
nPort == #port
dwServiceType == #service
Catatan
Untuk memanggil fungsi ini, proyek Anda harus menyertakan AFXINET.H.
Persyaratan
Header afxinet.h
AfxParseURLEx
Fungsi global ini adalah versi AfxParseURL yang diperluas dan digunakan dalam CInternetSession::OpenURL.
BOOL AFXAPI AfxParseURLEx(
LPCTSTR pstrURL,
DWORD& dwServiceType,
CString& strServer,
CString& strObject,
INTERNET_PORT& nPort,
CString& strUsername,
CString& strPassword,
DWORD dwFlags = 0);
Parameter
pstrURL
Penunjuk ke string yang berisi URL yang akan diurai.
dwServiceType
Menunjukkan jenis layanan Internet. Kemungkinan nilainya adalah sebagai berikut:
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
Segmen pertama URL mengikuti jenis layanan.
strObject
Objek yang dirujuk URL (mungkin kosong).
nPort
Ditentukan dari bagian Server atau Objek URL, jika ada.
strUsername
Referensi ke objek yang CString berisi nama pengguna.
strPassword
Referensi ke objek yang CString berisi kata sandi pengguna.
dwFlags
Bendera yang mengontrol cara mengurai URL. Bisa menjadi kombinasi dari nilai berikut:
| Nilai | Makna |
|---|---|
| ICU_DECODE | Konversikan %XX escape sequences menjadi karakter. |
| ICU_NO_ENCODE | Jangan konversi karakter yang tidak aman untuk meloloskan urutan. |
| ICU_NO_META | Jangan hapus urutan meta (seperti "\ ." dan "\ ..") dari URL. |
| ICU_ENCODE_SPACES_ONLY | Kodekan spasi saja. |
| ICU_BROWSER_MODE | Jangan mengodekan atau mendekode karakter setelah '#' atau '', dan jangan hapus spasi kosong berikutnya setelah ''. Jika nilai ini tidak ditentukan, seluruh URL dikodekan dan spasi kosong berikutnya dihapus. |
Jika Anda menggunakan default MFC, yang bukan bendera, fungsi mengonversi semua karakter yang tidak aman dan urutan meta (seperti \.,\ .., dan \...) untuk meloloskan urutan.
Tampilkan Nilai
Bukan nol jika URL berhasil diurai; jika tidak, 0 jika kosong atau tidak berisi jenis layanan Internet yang diketahui.
Keterangan
Ini mengurai string URL dan mengembalikan jenis layanan dan komponennya, serta memberikan nama dan kata sandi pengguna. Bendera menunjukkan bagaimana karakter yang tidak aman ditangani.
Catatan
Untuk memanggil fungsi ini, proyek Anda harus menyertakan AFXINET.H.
Persyaratan
Header afxinet.h
AfxGetInternetHandleType
Gunakan fungsi global ini untuk menentukan jenis handel Internet.
Sintaks
DWORD AFXAPI AfxGetInternetHandleType( HINTERNET hQuery );
Parameter
hQuery
Handel ke kueri Internet.
Tampilkan Nilai
Salah satu jenis layanan Internet yang ditentukan oleh WININET.H. Lihat bagian Keterangan untuk daftar layanan Internet ini. Jika handel null atau tidak dikenali, fungsi mengembalikan AFX_INET_SERVICE_UNK.
Keterangan
Daftar berikut ini mencakup kemungkinan jenis Internet yang dikembalikan oleh 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
Catatan
Untuk memanggil fungsi ini, proyek Anda harus menyertakan AFXINET.H.
Persyaratan
Header: afxinet.h
AfxThrowInternetException
Melempar pengecualian Internet.
Sintaks
void AFXAPI AfxThrowInternetException( DWORD dwContext, DWORD dwError = 0 );
Parameter
dwContext
Pengidentifikasi konteks untuk operasi yang menyebabkan kesalahan. Nilai default dwContext ditentukan awalnya dalam CInternetSession dan diteruskan ke kelas turunan CInternetConnection- dan CInternetFile. Untuk operasi tertentu yang dilakukan pada koneksi atau file, Anda biasanya mengambil alih default dengan dwContext Anda sendiri. Nilai ini kemudian dikembalikan ke CInternetSession::OnStatusCallback untuk mengidentifikasi status operasi tertentu.
dwError
Kesalahan yang menyebabkan pengecualian.
Keterangan
Anda bertanggung jawab untuk menentukan penyebabnya berdasarkan kode kesalahan sistem operasi.
Catatan
Untuk memanggil fungsi ini, proyek Anda harus menyertakan AFXINET.H.
Persyaratan
Header: afxinet.h