Fungsi UrlGetPartA (shlwapi.h)

Artikel
08/26/2023

Menerima string URL dan mengembalikan bagian tertentu dari URL tersebut.

Sintaks

LWSTDAPI UrlGetPartA(
  [in]      PCSTR pszIn,
  [out]     PSTR  pszOut,
  [in, out] DWORD *pcchOut,
            DWORD dwPart,
            DWORD dwFlags
);

Parameter

[in] pszIn

Jenis: PCTSTR

Untai (karakter) dengan panjang maksimum yang dihentikan null 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 dapat 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.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil. Nilai yang ditujukan 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 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


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