Fungsi DsGetIcon (dsclient.h)

Fungsi DsGetIcon mendapatkan ikon untuk kelas objek tertentu. Fungsi ini sudah usang. Aplikasi baru harus menggunakan metode IDsDisplaySpecifier::GetIcon untuk melakukan fungsi ini.

Sintaks

HICON DsGetIcon(
  [in] DWORD   dwFlags,
  [in] LPCWSTR pszObjectClass,
  [in] INT     cxImage,
  [in] INT     cyImage
);

Parameter

[in] dwFlags

Berisi sekumpulan bendera yang menunjukkan jenis ikon yang akan diambil. Ini bisa menjadi kombinasi dari satu atau beberapa nilai berikut.

DSGIF_ISNORMAL

Mendapatkan ikon normal untuk kelas objek.

DSGIF_ISOPEN

Mendapatkan ikon terbuka, seperti folder terbuka, untuk kelas objek. Jika kelas objek tidak memiliki ikon terbuka, fungsi ini mencoba untuk mendapatkan ikon normal untuk kelas objek.

DSGIF_ISDISABLED

Mendapatkan ikon yang dinonaktifkan, seperti pengguna yang dinonaktifkan, untuk kelas objek. Jika kelas objek tidak memiliki ikon yang dinonaktifkan, fungsi ini mencoba untuk mendapatkan ikon normal untuk kelas objek.

DSGIF_GETDEFAULTICON

Jika tidak ada ikon yang dapat ditemukan untuk kelas objek, fungsi ini akan mengembalikan ikon default. Jika bendera ini tidak ditentukan dan tidak ada ikon yang dapat ditemukan untuk kelas objek, fungsi ini mengembalikan NULL.

DSGIF_DEFAULTISCONTAINER

Jika tidak ada ikon yang dapat ditemukan untuk kelas objek, fungsi ini mengembalikan ikon kontainer sebagai ikon default. Jika bendera ini tidak ditentukan dan tidak ada ikon yang dapat ditemukan untuk kelas objek, fungsi ini mengembalikan NULL.

[in] pszObjectClass

Penunjuk ke string Unicode yang dihentikan null yang berisi nama kelas objek untuk mengambil ikon. Contoh nama kelas objek adalah "pengguna" dan "kontainer".

[in] cxImage

Berisi lebar yang diinginkan, dalam piksel, ikon . Fungsi ini mengambil ikon yang paling cocok dengan lebar ini.

[in] cyImage

Berisi tinggi yang diinginkan, dalam piksel, ikon . Fungsi ini mengambil ikon yang paling cocok dengan tinggi ini.

Nilai kembali

Mengembalikan handel ke ikon jika berhasil atau NULL sebaliknya. Pemanggil harus menghancurkan ikon ini ketika tidak lagi diperlukan dengan meneruskan handel ini ke DestroyIcon.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	dsclient.h
Pustaka	Dsuiext.lib
DLL	Dsuiext.dll

Lihat juga

DestroyIcon

IDsDisplaySpecifier::GetIcon