Struktur DSBITEMA (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 .

Sintaks

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  CHAR    szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  CHAR    szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMA, *PDSBITEMA;

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 menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.

DSBF_DISPLAYNAME

Anggota szDisplayName berisi data yang valid.

DSBF_ICONLOCATION

Anggota szIconLocation dan iIconResID berisi data yang valid.

DSBF_STATE

Anggota dwState dan dwStateMask berisi data yang valid.

dwState

Berisi sekumpulan bendera yang menunjukkan status item. Ini bisa menjadi 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 akan terlihat.

DSBS_ROOT

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

dwStateMask

Berisi sekumpulan bendera yang menunjukkan bendera mana di anggota dwState yang berisi data yang valid. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut. Misalnya, jika dwStateMask memiliki bendera DSBS_HIDDEN diatur dan dwState tidak memiliki bendera DSBS_HIDDEN yang ditetapkan, maka item terlihat. Jika dwStateMask tidak memiliki bendera DSBS_HIDDEN yang ditetapkan, 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 yang dihentikan null 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 tersebut. Ini bisa menjadi 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 bukan nol dari BFFCallBack.

iIconResID

Berisi indeks ikon berbasis nol yang akan ditampilkan untuk item.

Catatan Ini bukan pengidentifikasi sumber daya ikon.

 

Keterangan

Catatan

Header dsclient.h mendefinisikan DSBITEM 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 Vista
Server minimum yang didukung	Windows Server 2008
Header	dsclient.h

Lihat juga

BFFCallBack

DsBrowseForContainer

ExtractIcon