Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Struktur DSOP_SCOPE_INIT_INFO menjelaskan satu atau beberapa jenis cakupan yang memiliki atribut yang sama. Jenis cakupan adalah jenis lokasi, misalnya domain, komputer, atau Katalog Global, tempat pengguna dapat memilih objek. Struktur ini digunakan dengan DSOP_INIT_INFO saat memanggil IDsObjectPicker::Initialize.
Sintaks
typedef struct _DSOP_SCOPE_INIT_INFO {
ULONG cbSize;
ULONG flType;
ULONG flScope;
DSOP_FILTER_FLAGS FilterFlags;
PCWSTR pwzDcName;
PCWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
Anggota
cbSize
Berisi ukuran, dalam byte, dari struktur.
flType
Bendera yang menunjukkan jenis cakupan yang dijelaskan oleh struktur ini. Anda dapat menggabungkan beberapa jenis cakupan jika semua cakupan yang ditentukan menggunakan pengaturan yang sama. Anggota ini bisa menjadi kombinasi dari bendera berikut.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Komputer yang ditentukan oleh anggota pwzTargetComputer dari struktur DSOP_INIT_INFO .
Jika komputer target adalah pengontrol domain tingkat atas atau tingkat bawah, bendera ini diabaikan kecuali bendera DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK diatur dalam anggota flOptions dari struktur DSOP_INIT_INFO .
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Domain tingkat atas tempat komputer target bergabung. Jika bendera ini diatur, gunakan anggota pwzDcName untuk menentukan nama pengendali domain di domain yang bergabung.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Domain tingkat bawah tempat komputer target bergabung.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Semua domain di perusahaan tempat komputer target berada. Jika cakupan DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN ditentukan, maka cakupan DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN mewakili semua domain di perusahaan kecuali domain yang bergabung.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Cakupan yang berisi objek dari semua domain di perusahaan. Perusahaan hanya dapat berisi domain tingkat atas.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Semua domain tingkat atas di luar perusahaan tetapi dipercaya oleh domain tempat komputer target bergabung.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Semua domain tingkat bawah di luar perusahaan, tetapi dipercaya oleh domain tempat komputer target bergabung.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
Grup kerja tempat komputer target bergabung. Hanya berlaku jika komputer target tidak bergabung ke domain.
Satu-satunya tipe objek yang bisa dipilih dari grup kerja adalah komputer.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Memungkinkan pengguna memasukkan cakupan tingkat atas. Jika tidak ada jenis DSOP_SCOPE_TYPE_USER_ENTERED_* yang ditentukan, kotak dialog membatasi pengguna ke cakupan di daftar drop-down Lihat di .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Memungkinkan pengguna memasukkan cakupan tingkat bawah.
flScope
Bendera yang menunjukkan format yang digunakan untuk mengembalikan ADsPath untuk objek yang dipilih dari cakupan ini. Anggota flScope juga dapat menunjukkan cakupan awal yang ditampilkan di daftar drop-down Lihat di . Anggota ini bisa menjadi kombinasi dari bendera berikut.
Jalur LDAP dan Katalog Global (GC) dapat dikonversi ke Sintaks WinNT ADsPath. Jalur GC dapat dikonversi ke format LDAP. Objek WinNT yang memiliki atribut objectSid dapat dikonversi ke format LDAP jika Anda menentukan bendera DSOP_SCOPE_FLAG_WANT_SID_PATH atau DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP . Tidak ada konversi lain yang legal.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
Cakupan yang dijelaskan oleh struktur ini awalnya dipilih dalam daftar drop-down Lihat di . Hanya satu cakupan yang dapat menentukan bendera ini. Jika tidak ada cakupan yang menentukan bendera ini, cakupan awal adalah cakupan pertama yang berhasil dibuat dalam array cakupan yang diteruskan ke metode IDsObjectPicker::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
ADsPaths dikonversi untuk menggunakan penyedia WinNT. Untuk informasi selengkapnya, lihat WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
ADsPaths dikonversi untuk menggunakan penyedia LDAP. Untuk informasi selengkapnya, lihat LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
ADsPaths untuk objek yang dipilih dari cakupan ini dikonversi untuk menggunakan penyedia GC.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
ADsPaths yang memiliki atribut objectSid dikonversi ke formulir LDAP://< SID=x> di mana x mewakili digit heksadesimal dari nilai atribut objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
ADsPaths untuk objek SID tingkat bawah dan terkenal adalah string kosong kecuali bendera ini ditentukan (Misalnya; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Jika bendera ini ditentukan, jalur memiliki formulir
WinNT://NT pemilik AUTHORITY/Interactive atau WinNT://Creator.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Jika filter cakupan berisi pengguna, pilih kotak centang Pengguna dalam dialog.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Jika filter cakupan berisi grup, pilih kotak centang Grup dalam dialog.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Jika filter cakupan berisi komputer, pilih kotak centang Komputer dalam dialog.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Jika filter cakupan berisi kontak, pilih kotak centang Kontak dalam dialog.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Jika filter cakupan berisi akun layanan, pilih kotak centang Akun Layanan dan Akun Layanan Terkelola Grup dalam dialog.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Jika filter cakupan berisi objek pengaturan kata sandi, pilih kotak centang Objek Pengaturan Kata Sandi dalam dialog.
FilterFlags
Berisi struktur DSOP_FILTER_FLAGS yang menunjukkan jenis objek yang disajikan kepada pengguna untuk cakupan atau cakupan ini.
pwzDcName
Penunjuk ke string Unicode yang dihentikan null yang berisi nama pengendali domain domain tempat komputer target bergabung. Anggota ini hanya digunakan jika anggota flType berisi bendera DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Jika bendera tersebut tidak diatur, pwzDcName harus NULL.
Anggota ini bisa NULL meskipun bendera DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN ditentukan, dalam hal ini, kotak dialog mencari pengendali domain. Anggota ini memungkinkan Anda memberi nama pengendali domain tertentu di domain multimaster. Misalnya, aplikasi administratif mungkin membuat perubahan pada pengendali domain di domain multimaster, lalu membuka kotak dialog pemilih objek sebelum perubahan telah direplikasi pada pengendali domain lainnya.
pwzADsPath
Dipesan; harus NULL.
hr
Berisi nilai HRESULT yang menunjukkan status cakupan tertentu. Jika metode IDsObjectPicker::Initialize berhasil membuat cakupan, atau cakupan, yang ditentukan oleh struktur ini, jam berisi S_OK. Jika tidak, hr berisi kode kesalahan.
Jika IDsObjectPicker::Initialize mengembalikan S_OK, anggota hr dari semua struktur DSOP_SCOPE_INIT_INFO yang ditentukan juga berisi S_OK.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Header | objsel.h |