Struktur DSBITEMW (dsclient.h)

Struktur DSBITEM berisi data tentang item dalam kotak dialog browser kontainer Direktori Aktif. Struktur ini diteruskan dengan pemberitahuan DSBM_QUERYINSERT ke fungsi panggilan balik BFFCallBack. Kotak dialog browser kontainer dibuat dengan fungsi DsBrowseForContainer.

Sintaksis

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  WCHAR   szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  WCHAR   szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMW, *PDSBITEMW;

Anggota

cbStruct

Berisi ukuran, dalam byte, dari struktur.

pszADsPath

Penunjuk ke string Unicode yang dihentikan null yang berisi ADsPath item.

pszClass

Penunjuk ke string Unicode yang dihentikan null yang berisi nama kelas objek item.

dwMask

Berisi sekumpulan bendera yang menunjukkan anggota struktur mana yang berisi data yang valid. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DSBF_DISPLAYNAME

Anggota szDisplayName berisi data yang valid.

DSBF_ICONLOCATION

szIconLocation dan anggota iIconResID berisi data yang valid.

DSBF_STATE

dwState dan dwStateMask anggota berisi data yang valid.

dwState

Berisi sekumpulan bendera yang menunjukkan status item. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut.

DSBS_CHECKED

Jika bendera ini diatur, item dipilih. Jika tidak, item tidak dipilih. Bendera ini saat ini tidak didukung.

DSBS_HIDDEN

Jika bendera ini diatur, item disembunyikan. Jika tidak, item terlihat.

DSBS_ROOT

Jika bendera ini diatur, item adalah item akar. Jika tidak, item bukan item akar.

dwStateMask

Berisi sekumpulan bendera yang menunjukkan bendera mana di anggota dwState berisi data yang valid. Ini bisa nol atau kombinasi dari satu atau beberapa nilai berikut. Misalnya, jika dwStateMask memiliki set bendera DSBS_HIDDEN dan dwState tidak memiliki set bendera DSBS_HIDDEN, maka item terlihat. Jika dwStateMask tidak memiliki set bendera DSBS_HIDDEN, maka bendera DSBS_HIDDEN di dwState harus diabaikan.

DSBS_CHECKED

Bendera DSBS_CHECKED di anggota dwState berisi data yang valid.

DSBS_HIDDEN

Bendera DSBS_HIDDEN di anggota dwState berisi data yang valid.

DSBS_ROOT

Bendera DSBS_ROOT di anggota dwState berisi data yang valid.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Penunjuk ke string null-terminated yang berisi nama tampilan item. Nama tampilan item dapat diubah dengan menyalin nama tampilan baru ke anggota ini, mengatur bendera DSBF_DISPLAYNAME di anggota dwMask, dan mengembalikan nilai bukan nol dari BFFCallBack.

szIconLocation[MAX_PATH]

Penunjuk ke string yang dihentikan null yang berisi nama file .exe, .dll, atau .ico yang berisi ikon yang akan ditampilkan untuk item. Ini bisa berupa jenis file apa pun yang dapat diteruskan ke fungsi ExtractIcon. Indeks untuk ikon ini ditentukan dalam iIconResID. Untuk mengubah ikon yang ditampilkan untuk item, salin nama file sumber ikon ke anggota ini, atur iIconResID ke indeks ikon berbasis nol, atur bendera DSBF_ICONLOCATION di anggota dwMask, dan kembalikan nilai nonzero dari BFFCallBack.

iIconResID

Berisi indeks berbasis nol ikon yang akan ditampilkan untuk item.

Catatan Ini bukan pengidentifikasi sumber daya ikon.

 

Komentar

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Header	dsclient.h

Lihat juga

BFFCallBack

DsBrowseForContainer

ExtractIcon