struktur DSOP_INIT_INFO (objsel.h)

Struktur DSOP_INIT_INFO berisi data yang diperlukan untuk menginisialisasi kotak dialog pemilih objek. Struktur ini digunakan dengan metode IDsObjectPicker::Initialize .

Sintaks

typedef struct _DSOP_INIT_INFO {
  ULONG                 cbSize;
  PCWSTR                pwzTargetComputer;
  ULONG                 cDsScopeInfos;
  PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
  ULONG                 flOptions;
  ULONG                 cAttributesToFetch;
  PCWSTR                *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;

Anggota

cbSize

Berisi ukuran, dalam byte, dari struktur.

pwzTargetComputer

Penunjuk ke string Unicode yang dihentikan null yang berisi nama komputer target. Kotak dialog beroperasi seolah-olah berjalan pada komputer target, menggunakan komputer target untuk menentukan domain yang bergabung dan perusahaan. Jika nilai ini NULL, komputer target adalah komputer lokal.

cDsScopeInfos

Menentukan jumlah elemen dalam array aDsScopeInfos .

aDsScopeInfos

Penunjuk ke array struktur DSOP_SCOPE_INIT_INFO yang menjelaskan cakupan tempat pengguna dapat memilih objek. Anggota ini tidak boleh NULL dan array harus berisi setidaknya satu elemen karena pemilih objek tidak dapat beroperasi tanpa setidaknya satu cakupan.

flOptions

Bendera yang menentukan opsi pemilih objek. Anggota ini bisa menjadi nol atau kombinasi dari satu atau beberapa bendera berikut.

DSOP_FLAG_MULTISELECT (0x00000001)

Jika bendera ini diatur, pengguna dapat memilih beberapa objek. Jika bendera ini tidak diatur, pengguna hanya dapat memilih satu objek.

DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)

Jika bendera ini diatur dan bendera DSOP_SCOPE_TYPE_TARGET_COMPUTER diatur dalam array aDsScopeInfos , komputer target selalu disertakan dalam daftar drop-down Lihat di .

Jika bendera ini tidak diatur dan komputer target adalah pengontrol domain tingkat atas atau bawah, bendera DSOP_SCOPE_TYPE_TARGET_COMPUTER diabaikan dan komputer target tidak disertakan dalam daftar drop-down Lihat di .

Untuk menghemat waktu selama inisialisasi, bendera ini harus diatur jika diketahui bahwa komputer target bukan pengendali domain. Namun, jika komputer target adalah pengendali domain, bendera ini tidak boleh diatur karena lebih baik bagi pengguna untuk memilih objek domain dari cakupan domain daripada dari pengendali domain itu sendiri.

cAttributesToFetch

Berisi jumlah elemen dalam array apwzAttributeNames . Anggota ini bisa nol.

apwzAttributeNames

Penunjuk ke array string Unicode yang dihentikan null yang berisi nama atribut yang akan diambil untuk setiap objek yang dipilih. Jika cAttributesToFetch adalah nol, anggota ini diabaikan.

Persyaratan

Lihat juga

DSOP_SCOPE_INIT_INFO

Pemilih Objek Direktori

IDsObjectPicker::Initialize