struktur URL_COMPONENTSA (wininet.h)
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
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 |