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

Lihat juga

ADsOpenObject

CFSTR_DS_DISPLAY_SPEC_OPTIONS

Tampilkan Struktur dalam Active Directory Domain Services