struttura DSOP_SCOPE_INIT_INFO (objsel.h)
La struttura DSOP_SCOPE_INIT_INFO descrive uno o più tipi di ambito con gli stessi attributi. Un tipo di ambito è un tipo di percorso, ad esempio un dominio, un computer o un catalogo globale, da cui l'utente può selezionare gli oggetti. Questa struttura viene usata con DSOP_INIT_INFO quando si chiama IDsObjectPicker::Initialize.
Sintassi
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;
Members
cbSize
Contiene le dimensioni, in byte, della struttura.
flType
Flag che indicano i tipi di ambito descritti da questa struttura. È possibile combinare più tipi di ambito se tutti gli ambiti specificati usano le stesse impostazioni. Questo membro può essere una combinazione dei flag seguenti.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Computer specificato dal membro pwzTargetComputer della struttura DSOP_INIT_INFO .
Se il computer di destinazione è un controller di dominio di livello superiore o inferiore, questo flag viene ignorato a meno che il flag DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK non sia impostato nel membro flOptions della struttura DSOP_INIT_INFO .
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Dominio di livello superiore a cui viene aggiunto il computer di destinazione. Se questo flag è impostato, usare il membro pwzDcName per specificare il nome di un controller di dominio nel dominio aggiunto.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Dominio di livello inferiore a cui viene aggiunto il computer di destinazione.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Tutti i domini dell'organizzazione a cui appartiene il computer di destinazione. Se viene specificato l'ambito DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN , l'ambito DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN rappresenta tutti i domini dell'organizzazione ad eccezione del dominio aggiunto.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Ambito che contiene oggetti di tutti i domini dell'organizzazione. Un'organizzazione può contenere solo domini di livello superiore.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Tutti i domini di livello superiore esterni all'azienda, ma considerati attendibili dal dominio a cui viene aggiunto il computer di destinazione.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Tutti i domini di livello inferiore esterni all'organizzazione, ma considerati attendibili dal dominio a cui viene aggiunto il computer di destinazione.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
Gruppo di lavoro a cui viene aggiunto il computer di destinazione. Si applica solo se il computer di destinazione non è aggiunto a un dominio.
L'unico tipo di oggetto che può essere selezionato da un gruppo di lavoro è un computer.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Consente all'utente di immettere un ambito di livello superiore. Se non viene specificato nessuno dei tipi DSOP_SCOPE_TYPE_USER_ENTERED_* , la finestra di dialogo limita l'utente agli ambiti nell'elenco a discesa Cerca in .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Consente all'utente di immettere un ambito di livello inferiore.
flScope
Flag che indicano il formato utilizzato per restituire ADsPath per gli oggetti selezionati da questo ambito. Il membro flScope può anche indicare l'ambito iniziale visualizzato nell'elenco a discesa Cerca in . Questo membro può essere una combinazione dei flag seguenti.
I percorsi LDAP e GC (Global Catalog) possono essere convertiti nella sintassi WinNT ADsPath. I percorsi GC possono essere convertiti nel formato LDAP. Gli oggetti WinNT con un attributo objectSid possono essere convertiti nel formato LDAP se si specificano i flag DSOP_SCOPE_FLAG_WANT_SID_PATH o DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP . Nessun'altra conversione è legale.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
L'ambito descritto da questa struttura viene inizialmente selezionato nell'elenco a discesa Cerca in . Solo un ambito può specificare questo flag. Se non viene specificato alcun ambito, l'ambito iniziale è il primo ambito creato correttamente nella matrice di ambiti passati al metodo IDsObjectPicker::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Gli ADsPath vengono convertiti per l'uso del provider WinNT. Per altre informazioni, vedere WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Gli ADsPath vengono convertiti per l'uso del provider LDAP. Per altre informazioni, vedere LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
Gli ADsPath per gli oggetti selezionati da questo ambito vengono convertiti per l'utilizzo del provider GC.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
Gli ADsPath con un attributo objectSid vengono convertiti nel form LDAP://< SID=x> dove x rappresenta le cifre esadecimali del valore dell'attributo objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Gli ADsPath per gli oggetti SID noti di livello inferiore sono una stringa vuota a meno che non venga specificato questo flag( ad esempio; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Se questo flag viene specificato, i percorsi hanno il form
WinNT://NT PROPRIETARIO AUTHORITY/Interactive o WinNT://Creator.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Se il filtro di ambito contiene utenti, selezionare la casella di controllo Utenti nella finestra di dialogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Se il filtro di ambito contiene gruppi, selezionare la casella di controllo Gruppi nella finestra di dialogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Se il filtro di ambito contiene computer, selezionare la casella di controllo Computer nella finestra di dialogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Se il filtro di ambito contiene contatti, selezionare la casella di controllo Contatti nella finestra di dialogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Se il filtro di ambito contiene account di servizio, selezionare le caselle di controllo Account del servizio e Account del servizio gestito di gruppo nella finestra di dialogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Se il filtro di ambito contiene oggetti impostazione password, selezionare la casella di controllo Oggetti impostazione password nella finestra di dialogo.
FilterFlags
Contiene una struttura DSOP_FILTER_FLAGS che indica i tipi di oggetti presentati all'utente per questo ambito o ambiti.
pwzDcName
Puntatore a una stringa Unicode con terminazione Null contenente il nome di un controller di dominio del dominio a cui viene aggiunto il computer di destinazione. Questo membro viene utilizzato solo se il membro flType contiene il flag di DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Se il flag non è impostato, pwzDcName deve essere NULL.
Questo membro può essere NULL anche se viene specificato il flag di DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN , nel qual caso la finestra di dialogo cerca il controller di dominio. Questo membro consente di assegnare un nome a un controller di dominio specifico in un dominio multimaster. Ad esempio, un'applicazione amministrativa potrebbe apportare modifiche a un controller di dominio in un dominio multimaster e quindi aprire la finestra di dialogo selezione oggetti prima che le modifiche siano state replicate negli altri controller di dominio.
pwzADsPath
Riservati; deve essere NULL.
hr
Contiene un valore HRESULT che indica lo stato dell'ambito specifico. Se il metodo IDsObjectPicker::Initialize crea correttamente l'ambito o gli ambiti specificati da questa struttura, hr contiene S_OK. In caso contrario, hr contiene un codice di errore.
Se IDsObjectPicker::Initialize restituisce S_OK, anche i membri hr di tutte le strutture DSOP_SCOPE_INIT_INFO specificate contengono S_OK.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | objsel.h |