struktur URL_COMPONENTS (winhttp.h)

Struktur URL_COMPONENTS berisi bagian konstituen URL. Struktur ini digunakan dengan fungsi WinHttpCrackUrl dan WinHttpCreateUrl .

Sintaks

typedef struct _WINHTTP_URL_COMPONENTS {
  DWORD           dwStructSize;
  LPWSTR          lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPWSTR          lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPWSTR          lpszUserName;
  DWORD           dwUserNameLength;
  LPWSTR          lpszPassword;
  DWORD           dwPasswordLength;
  LPWSTR          lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPWSTR          lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTS, *LPURL_COMPONENTS;

Anggota

dwStructSize

Ukuran struktur ini, dalam byte. Digunakan untuk pemeriksaan versi. Ukuran struktur ini harus diatur untuk menginisialisasi struktur ini dengan benar.

lpszScheme

Penunjuk ke nilai string yang berisi nama skema.

dwSchemeLength

Panjang nama skema, dalam karakter.

nScheme

Skema protokol internet. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
INTERNET_SCHEME_HTTP 1	Skema Internet adalah protokol HTTP. Lihat RFC 2616 untuk informasi selengkapnya.
INTERNET_SCHEME_HTTPS 2	Skema Internet, HTTPS, adalah protokol HTTP yang menggunakan semantik transaksi aman.

lpszHostName

Penunjuk ke nilai string yang berisi nama host.

dwHostNameLength

Panjang nama host, dalam karakter.

nPort

Nomor port.

lpszUserName

Penunjuk ke string yang berisi nama pengguna.

dwUserNameLength

Panjang nama pengguna, dalam karakter.

lpszPassword

Penunjuk ke string yang berisi kata sandi.

dwPasswordLength

Panjang kata sandi, dalam karakter.

lpszUrlPath

Penunjuk ke string yang berisi jalur URL.

dwUrlPathLength

Panjang jalur URL, dalam karakter.

lpszExtraInfo

Penunjuk ke nilai string yang berisi informasi tambahan, misalnya, ?something atau #something.

dwExtraInfoLength

Nilai bilangan bulat panjang yang tidak ditandatangani yang berisi panjang informasi tambahan, dalam karakter.

Keterangan

Untuk fungsi WinHttpCrackUrl , jika anggota penunjuk dan anggota panjang yang sesuai sama-sama nol, komponen URL tersebut tidak dikembalikan. Jika anggota pointer adalah NULL tetapi anggota panjangnya bukan nol, penunjuk dan anggota panjang dikembalikan. Jika penunjuk dan anggota panjang yang sesuai bukan nol, anggota penunjuk menunjuk ke buffer tempat komponen disalin. Semua urutan escape dapat dihapus dari komponen, tergantung pada parameter dwFlagsWinHttpCrackUrl.

Untuk fungsi WinHttpCreateUrl , anggota pointer harus NULL jika komponen URL tidak diperlukan. Jika anggota panjang yang sesuai adalah nol, anggota penunjuk adalah penunjuk ke string yang dihentikan nol. Jika anggota panjang bukan nol, itu adalah panjang string anggota pointer yang sesuai.

Catatan Untuk Windows XP dan Windows 2000, lihat bagian Persyaratan Run-Time di halaman mulai WinHttp.

 

Persyaratan

Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Header	winhttp.h
Redistribusi	WinHTTP 5.0 dan Internet Explorer 5.01 atau yang lebih baru di Windows XP dan Windows 2000.

Lihat juga

Versi WinHTTP