struttura DSOP_INIT_INFO (objsel.h)
La struttura DSOP_INIT_INFO contiene i dati necessari per inizializzare una finestra di dialogo di selezione oggetti. Questa struttura viene utilizzata con il metodo IDsObjectPicker::Initialize .
Sintassi
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;
Members
cbSize
Contiene le dimensioni, in byte, della struttura.
pwzTargetComputer
Puntatore a una stringa Unicode con terminazione Null contenente il nome del computer di destinazione. La finestra di dialogo funziona come se fosse in esecuzione nel computer di destinazione, utilizzando il computer di destinazione per determinare il dominio aggiunto e l'organizzazione. Se questo valore è NULL, il computer di destinazione è il computer locale.
cDsScopeInfos
Specifica il numero di elementi nella matrice aDsScopeInfos .
aDsScopeInfos
Puntatore a una matrice di strutture DSOP_SCOPE_INIT_INFO che descrivono gli ambiti da cui l'utente può selezionare gli oggetti. Questo membro non può essere NULL e la matrice deve contenere almeno un elemento perché la selezione oggetti non può funzionare senza almeno un ambito.
flOptions
Flag che determinano le opzioni di selezione oggetti. Questo membro può essere zero o una combinazione di uno o più dei flag seguenti.
DSOP_FLAG_MULTISELECT (0x00000001)
Se questo flag è impostato, l'utente può selezionare più oggetti. Se questo flag non è impostato, l'utente può selezionare un solo oggetto.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
Se questo flag è impostato e il flag DSOP_SCOPE_TYPE_TARGET_COMPUTER è impostato nella matrice aDsScopeInfos , il computer di destinazione viene sempre incluso nell'elenco a discesa Cerca in .
Se questo flag non è impostato e il computer di destinazione è un controller di dominio di livello superiore o inferiore, il flag di DSOP_SCOPE_TYPE_TARGET_COMPUTER viene ignorato e il computer di destinazione non è incluso nell'elenco a discesa Cerca in .
Per risparmiare tempo durante l'inizializzazione, questo flag deve essere impostato se è noto che il computer di destinazione non è un controller di dominio. Tuttavia, se il computer di destinazione è un controller di dominio, questo flag non deve essere impostato perché è preferibile per l'utente selezionare oggetti di dominio dall'ambito del dominio anziché dal controller di dominio stesso.
cAttributesToFetch
Contiene il numero di elementi nella matrice apwzAttributeNames . Questo membro può essere zero.
apwzAttributeNames
Puntatore a una matrice di stringhe Unicode con terminazione Null che contengono i nomi degli attributi da recuperare per ogni oggetto selezionato. Se cAttributesToFetch è zero, questo membro viene ignorato.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | objsel.h |