struktur URL_COMPONENTSA (wininet.h)

Artikel
03/13/2024

Berisi bagian konstituen url. Struktur ini digunakan dengan fungsi InternetCrackUrl dan InternetCreateUrl .

Sintaks

typedef struct {
  DWORD           dwStructSize;
  LPSTR           lpszScheme;
  DWORD           dwSchemeLength;
  INTERNET_SCHEME nScheme;
  LPSTR           lpszHostName;
  DWORD           dwHostNameLength;
  INTERNET_PORT   nPort;
  LPSTR           lpszUserName;
  DWORD           dwUserNameLength;
  LPSTR           lpszPassword;
  DWORD           dwPasswordLength;
  LPSTR           lpszUrlPath;
  DWORD           dwUrlPathLength;
  LPSTR           lpszExtraInfo;
  DWORD           dwExtraInfoLength;
} URL_COMPONENTSA, *LPURL_COMPONENTSA;

Anggota

dwStructSize

Ukuran struktur ini, dalam byte.

lpszScheme

Penunjuk ke string yang berisi nama skema.

dwSchemeLength

Ukuran nama skema, dalam TCHAR.

nScheme

INTERNET_SCHEME nilai yang menunjukkan skema protokol Internet.

lpszHostName

Penunjuk ke string yang berisi nama host.

dwHostNameLength

Ukuran nama host, dalam TCHAR.

nPort

Nomor port yang dikonversi.

lpszUserName

Penunjuk ke nilai string yang berisi nama pengguna.

dwUserNameLength

Ukuran nama pengguna, dalam TCHAR.

lpszPassword

Penunjuk ke string yang berisi kata sandi.

dwPasswordLength

Ukuran kata sandi, dalam TCHAR.

lpszUrlPath

Penunjuk ke string yang berisi jalur URL.

dwUrlPathLength

Ukuran jalur URL, dalam TCHAR.

lpszExtraInfo

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

dwExtraInfoLength

Ukuran informasi tambahan, dalam TCHAR.

Keterangan

Untuk InternetCrackUrl, jika anggota pointer dan anggota panjang yang sesuai sama-sama nol, komponen 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. Komponen dapat tidak lolos, tergantung pada parameter dwFlagsInternetCrackUrl.

Untuk InternetCreateUrl, anggota pointer harus NULL jika komponen tidak diperlukan. Jika anggota panjang yang sesuai adalah nol, anggota penunjuk adalah alamat string yang dihentikan nol. Jika anggota panjang bukan nol, itu adalah panjang string anggota pointer yang sesuai.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

Catatan

Header wininet.h mendefinisikan URL_COMPONENTS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	wininet.h

Lihat juga

InternetCrackUrl

InternetCreateUrl

Bagikan melalui