Struktur DSDISPLAYSPECOPTIONS (dsclient.h)
Struktur DSDISPLAYSPECOPTIONS dikembalikan oleh format clipboard CFSTR_DS_DISPLAY_SPEC_OPTIONS dan digunakan untuk memasok data ke menu konteks atau ekstensi halaman properti tentang penentu tampilan yang digunakan. Penting untuk menentukan kredensial yang diperlukan oleh ekstensi, untuk mengakses data di server Direktori Aktif.
Sintaks
typedef struct _DSDISPLAYSPECOPTIONS {
DWORD dwSize;
DWORD dwFlags;
DWORD offsetAttribPrefix;
DWORD offsetUserName;
DWORD offsetPassword;
DWORD offsetServer;
DWORD offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;
Anggota
dwSize
Ukuran struktur untuk tujuan penerapan versi.
dwFlags
Sekumpulan bendera yang menunjukkan data tentang objek dan menentukan konten struktur. Ini bisa menjadi nol atau kombinasi dari satu atau beberapa nilai berikut.
DSDSOF_HASUSERANDSERVERINFO (0x00000001)
Anggota offsetUserName, offsetPassword, offsetServer , dan offsetServerConfigPath valid.
DSDSOF_SIMPLEAUTHENTICATE (0x00000002)
Jangan tentukan bendera ADS_SECURE_AUTHENTICATION saat memanggil ADsOpenObject.
DSDSOF_DONTSIGNSEAL (0x00000004)
Jangan menandatangani dan menutup saat membuka objek layanan direktori.
DSDSOF_DSAVAILABLE (0x40000000)
Memaksa klien untuk menghindari pemeriksaan apakah pengguna diautentikasi, jaringan ada atau masuk, dengan asumsi klien milik domain yang dikendalikan oleh Active Directory Domain Services.
offsetAttribPrefix
Berisi offset, dalam byte, dari awal struktur DSDISPLAYSPECOPTIONS hingga string Unicode yang dihentikan NULL yang berisi awalan penentu tampilan tempat ekstensi yang dibuat diperoleh. String ini bisa menjadi salah satu nilai berikut.
"admin"
Ekstensi diperoleh dari atribut adminPropertyPages .
"shell"
Ekstensi diperoleh dari atribut shellPropertyPages .
Contoh berikut menunjukkan cara menggunakan anggota ini.
pwszAttribPrefix = (LPWSTR)((LPBYTE)pdos +
pdso->offsetAttribPrefix);
offsetUserName
Berisi offset, dalam byte, dari awal struktur DSDISPLAYSPECOPTIONS hingga string Unicode yang dihentikan NULL yang berisi nama pengguna yang digunakan untuk mengautentikasi ikatan. Anggota ini hanya valid jika dwFlags berisi bendera DSDSOF_HASUSERANDSERVERINFO . Jika anggota ini berisi nol, nama pengguna tidak disertakan.
Contoh berikut menunjukkan cara menggunakan anggota ini.
pwszUserName = (LPWSTR)((LPBYTE)pdso +
pdso->offsetUserName);
offsetPassword
Berisi offset, dalam byte, dari awal struktur DSDISPLAYSPECOPTIONS hingga string Unicode yang dihentikan NULL yang berisi kata sandi yang digunakan untuk mengautentikasi ikatan. Anggota ini hanya valid jika dwFlags berisi bendera DSDSOF_HASUSERANDSERVERINFO . Jika anggota ini berisi nol, kata sandi tidak disertakan.
Contoh berikut menunjukkan cara menggunakan anggota ini.
pwszPassword = (LPWSTR)((LPBYTE)pdso +
pdso->offsetPassword);
offsetServer
Berisi offset, dalam byte, dari awal struktur DSDISPLAYSPECOPTIONS hingga string Unicode yang dihentikan NULL yang berisi nama server. Anggota ini hanya valid jika dwFlags berisi bendera DSDSOF_HASUSERANDSERVERINFO . Jika anggota ini berisi nol, nama server tidak disertakan.
Contoh berikut menunjukkan cara menggunakan anggota ini.
pwszServer = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServer);
offsetServerConfigPath
Berisi offset, dalam byte, dari awal struktur DSDISPLAYSPECOPTIONS hingga string Unicode yang dihentikan NULL yang berisi ADsPath server. Anggota ini hanya valid jika dwFlags berisi bendera DSDSOF_HASUSERANDSERVERINFO . Jika anggota ini berisi nol, jalur server tidak disertakan.
Contoh berikut menunjukkan cara menggunakan anggota ini.
pwszServerConfigPath = (LPWSTR)((LPBYTE)pdso +
pdso->offsetServerConfigPath);
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Header | dsclient.h |