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.
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 |