Fungsi UrlGetPartW (shlwapi.h)

Artikel
03/04/2024

Menerima string URL dan mengembalikan bagian tertentu dari URL tersebut.

Sintaks

LWSTDAPI UrlGetPartW(
  [in]      PCWSTR pszIn,
  [out]     PWSTR  pszOut,
  [in, out] DWORD  *pcchOut,
            DWORD  dwPart,
            DWORD  dwFlags
);

Parameter

[in] pszIn

Jenis: PCTSTR

String yang dihentikan null dengan panjang maksimum INTERNET_MAX_URL_LENGTH yang berisi URL.

[out] pszOut

Jenis: PTSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima string yang dihentikan null dengan bagian URL yang ditentukan.

[in, out] pcchOut

Jenis: DWORD*

Penunjuk ke nilai yang, pada entri, diatur ke jumlah karakter dalam buffer pszOut . Ketika fungsi ini berhasil dikembalikan, nilai tergantung pada apakah fungsi berhasil atau mengembalikan E_POINTER. Untuk nilai pengembalian lainnya, nilai parameter ini tidak ada artinya.

dwPart

Jenis: DWORD

Bendera yang menentukan bagian URL mana yang akan diambil. Ini bisa memiliki salah satu nilai berikut.

URL_PART_HOSTNAME

Nama host.

URL_PART_PASSWORD

Kata sandi.

URL_PART_PORT

Nomor port.

URL_PART_QUERY

Bagian kueri URL.

URL_PART_SCHEME

Skema URL.

URL_PART_USERNAME

Nama pengguna.

dwFlags

Jenis: DWORD

Bendera yang dapat diatur untuk menyimpan skema URL, selain bagian yang ditentukan oleh dwPart.

URL_PARTFLAG_KEEPSCHEME

Pertahankan skema URL.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil. Nilai yang ditujukkan oleh pcchOut akan diatur ke jumlah karakter yang ditulis ke buffer output, tidak termasuk NULL yang mengakhiri. Jika buffer terlalu kecil, E_POINTER dikembalikan, dan nilai yang diacu oleh pcchOut akan diatur ke jumlah karakter minimum yang harus dapat dimuat buffer, termasuk karakter NULL yang mengakhiri. Jika tidak, nilai kesalahan COM dikembalikan.

Keterangan

Catatan

Header shlwapi.h mendefinisikan UrlGetPart sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui