Bagikan melalui

Fungsi WsDecodeUrl (webservices.h)

  • Artikel

Mengevaluasi komponen URL untuk menentukan "skema" -nya. Nilai WS_URL_SCHEME_TYPE dienkapulatasi dalam struktur WS_URL dan referensi ke struktur dikembalikan melalui parameter output. Jika skema tidak dikenali, fungsi akan mengembalikan WS_E_INVALID_FORMAT.
Hanya jenis skema yang diidentifikasi di WS_URL_SCHEME_TYPE yang didukung.

Sintaks

HRESULT WsDecodeUrl(
  [in]           const WS_STRING *url,
  [in]           ULONG           flags,
  [in]           WS_HEAP         *heap,
                 WS_URL          **outUrl,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] url

Penunjuk ke representasi WS_STRING URL untuk dievaluasi.

[in] flags

Menentukan metode evaluasi skema URL. Lihat WS_URL_FLAGS.

[in] heap

Penunjuk ke WS_HEAP untuk mengalokasikan referensi URL yang dikembalikan.

outUrl

Referensi ke struktur WS_URL yang merangkum nilai WS_URL_SCHEME_TYPE .

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY
 Kehabisan memori.
WS_E_INVALID_FORMAT
 URL input tidak dalam format yang benar, atau skema tidak dikenali.
Kesalahan Lainnya
Fungsi ini dapat mengembalikan kesalahan lain yang tidak tercantum di atas.

Keterangan

Tata bahasa yang diuraikan untuk skema "http", "https", "net.tcp" dan "soap.udp" dapat ditemukan di http://www.ietf.org/rfc/rfc3986.txt. Untuk skema ini:

  • Nama host yang tidak kosong diperlukan.
  • Untuk produksi IP-literal, semua karakter yang didemarasi oleh "[" dan "]" dikembalikan. Mereka tidak diberlakukan untuk mengikuti produksi IPv6Address.
  • Bagian otoritas userinfo (misalnya, userinfo@hostname:port) tidak didukung.

Jika tidak ada port yang ditentukan, port default untuk skema tersebut dikembalikan.

Jika tidak ada port yang ditentukan untuk skema soap.udp 0xFFFFFFFF dikembalikan sebagai default.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header webservices.h
Pustaka WebServices.lib
DLL WebServices.dll