Fungsi MIMEAssociationDialogW (intshcut.h)

Artikel
08/24/2023

Menjalankan kotak dialog tipe konten MIME yang tidak terdaftar.

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

Sintaks

INTSHCUTAPI HRESULT MIMEAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszMIMEContentType,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

Parameter

hwndParent

Jenis: HWND

Handel ke jendela induk dari jendela turunan yang diposting.

dwInFlags

Jenis: DWORD

Nilai bendera bit yang menentukan apakah asosiasi akan didaftarkan. Bendera bit adalah nilai MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Jika bit ini diatur, aplikasi yang dipilih terdaftar sebagai handler untuk jenis MIME yang diberikan. Jika bit ini jelas, tidak ada asosiasi yang terdaftar.

Aplikasi didaftarkan hanya jika bendera ini diatur dan pengguna menunjukkan bahwa asosiasi persisten akan dibuat.

Pendaftaran tidak mungkin jika string di pcszFile tidak berisi ekstensi.

pcszFile

Jenis: PCTSTR

Alamat string yang dihentikan null yang berisi nama file target. File ini harus sesuai dengan tipe isi yang dijelaskan oleh parameter pcszMIMEContentType .

pcszMIMEContentType

Jenis: PCTSTR

Alamat string yang dihentikan null yang berisi jenis konten yang tidak terdaftar.

[out] pszAppBuf

Jenis: PTSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, 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 jenis konten berhasil dikaitkan dengan ekstensi. Dalam hal ini, ekstensi dikaitkan sebagai default untuk jenis konten, dan pszAppBuf menunjuk ke string yang berisi jalur aplikasi yang ditentukan. Fungsi mengembalikan S_FALSE jika tidak ada yang terdaftar. Jika tidak, nilai yang dikembalikan akan menjadi salah satu dari yang berikut ini:

Menampilkan kode	Deskripsi
E_ABORT	Pengguna membatalkan operasi.
E_FLAGS	Kombinasi bendera yang diteruskan dalam dwInFlags tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi.
E_POINTER	Salah satu penunjuk input tidak valid.

Keterangan

Fungsi ini tidak memvalidasi sintaks string jenis konten input di pcszMIMEContentType. Nilai pengembalian yang berhasil tidak menunjukkan bahwa tipe konten MIME yang ditentukan valid.

Catatan

Header intshcut.h mendefinisikan MIMEAssociationDialog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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