Fungsi URLAssociationDialogA (intshcut.h)

Artikel
02/29/2024

Memanggil kotak dialog protokol URL yang tidak terdaftar. Kotak dialog ini memungkinkan pengguna untuk memilih aplikasi untuk dikaitkan dengan protokol yang sebelumnya tidak diketahui.

Catatan Windows XP Service Pack 2 (SP2) atau yang lebih baru: Fungsi ini tidak lagi didukung.

Sintaks

INTSHCUTAPI HRESULT URLAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszURL,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parameter

hwndParent

Jenis: HWND

Handel ke jendela induk.

dwInFlags

Jenis: DWORD

Bendera bit yang menentukan perilaku fungsi. Nilai ini bisa menjadi kombinasi dari yang berikut ini:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Gunakan nama file default (yaitu, "Pintasan Internet").

URLASSOCDLG_FL_REGISTER_ASSOC

Daftarkan aplikasi yang dipilih sebagai handler untuk protokol yang ditentukan dalam pcszURL. Aplikasi didaftarkan hanya jika bendera ini diatur dan pengguna menunjukkan bahwa asosiasi persisten diinginkan.

pcszFile

Jenis: PTCSTR

Alamat string konstanta yang dihentikan nol yang berisi nama file untuk dikaitkan dengan protokol URL.

pcszURL

Jenis: PTCSTR

Alamat string konstanta yang dihentikan nol yang berisi URL dengan protokol yang tidak diketahui.

[out] pszAppBuf

Jenis: PTSTR

Alamat buffer yang menerima jalur aplikasi yang ditentukan oleh pengguna.

ucAppBufLen

Jenis: UINT

Ukuran pszAppBuf, dalam karakter.

Mengembalikan nilai

Jenis: HRESULT

Catatan Pada Windows XP SP2, fungsi ini tidak didukung dan mengembalikan E_NOTIMPL dalam semua situasi.

Dalam sistem yang didukung, mengembalikan S_OK jika aplikasi terdaftar dengan protokol URL, atau S_FALSE jika tidak ada yang terdaftar. Misalnya, fungsi mengembalikan S_FALSE ketika pengguna memilih untuk melakukan eksekusi satu kali melalui aplikasi yang dipilih.

Keterangan

Catatan

Header intshcut.h mendefinisikan URLAssociationDialog 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 XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	intshcut.h
DLL	Url.dll

Bagikan melalui