Struttura OPENQUERYWINDOW (cmnquery.h)
La struttura OPENQUERYWINDOW viene utilizzata con il metodo ICommonQuery::OpenQueryWindow per inizializzare la finestra di dialogo query del servizio directory.
Sintassi
typedef struct {
DWORD cbStruct;
DWORD dwFlags;
CLSID clsidHandler;
LPVOID pHandlerParameters;
CLSID clsidDefaultForm;
IPersistQuery *pPersistQuery;
union {
void *pFormParameters;
IPropertyBag *ppbFormParameters;
};
} OPENQUERYWINDOW, *LPOPENQUERYWINDOW;
Members
cbStruct
Contiene le dimensioni, in byte, della struttura. Questo membro viene usato per il controllo delle versioni e la convalida dei parametri e deve essere compilato prima di chiamare ICommonQuery::OpenQueryWindow.
dwFlags
Contiene un set di flag che definiscono il comportamento della finestra di dialogo query del servizio directory. Può essere zero o una combinazione di uno o più valori elencati nell'elenco seguente.
OQWF_DEFAULTFORM
Fa sì che la finestra di dialogo query selezioni il modulo specificato dal membro clsidDefaultForm all'inizializzazione.
OQWF_HIDEMENUS
Fa sì che la finestra di dialogo nasconda la barra dei menu.
OQWF_HIDESEARCHUI
Fa sì che la finestra di dialogo query venga creata senza l'interfaccia utente di ricerca standard. Sono inclusi i pulsanti Trova ora, Arresta e Cancella tutti .
OQWF_ISSUEONOPEN
Fa sì che la query venga eseguita per la prima volta quando viene visualizzata la finestra di dialogo query.
OQWF_LOADQUERY
Fa sì che la finestra di dialogo query recuperi la query dall'interfaccia IPersistQuery nel membro pPersistQuery .
OQWF_OKCANCEL
Fa sì che la finestra di dialogo query visualizzi i pulsanti OK e Annulla , se applicabile. I pulsanti effettivamente visualizzati nella finestra di dialogo dipendono dal modulo utilizzato e da altri flag specificati.
OQWF_PARAMISPROPERTYBAG
Indica che il membro ppbFormParameters contiene un'interfaccia IPropertyBag .
OQWF_REMOVEFORMS
Fa sì che la finestra di dialogo query venga creata senza l'etichetta e l'elenco a discesa della selezione modulo rappresentati dall'etichetta Trova: .
OQWF_REMOVESCOPES
Fa sì che la finestra di dialogo query venga creata senza l'etichetta dell'ambito e l'elenco a discesa rappresentati dall'etichetta In: .
OQWF_SAVEQUERYONOK
Determina la chiusura della finestra di dialogo query per salvare la query nell'interfaccia IPersistQuery nel membro pPersistQuery .
OQWF_SHOWOPTIONAL
Fa sì che la finestra di dialogo query visualizzi i moduli facoltativi nell'elenco a discesa del modulo. I moduli facoltativi sono moduli che specificano il flag CQFF_ISOPTIONAL nel membro dwFlags della struttura CQFORM .
OQWF_SINGLESELECT
Fa sì che la finestra di dialogo query eseghi l'elenco dei risultati della query a selezione singola.
clsidHandler
Contiene un valore CLSID che specifica il gestore di query da utilizzare nella finestra di dialogo query. Il valore di questo membro determina anche il tipo di struttura a cui punta il membro pHandlerParameters .
CLSID_DsQuery
Questa è la query del servizio directory standard e l'unica query attualmente supportata.
pHandlerParameters
Puntatore a una struttura che contiene dati per il gestore di query. Il tipo di struttura a cui punta questo membro è definito dal membro clsidHandler . Nell'elenco seguente sono elencati i possibili tipi di strutture in base al valore del membro clsidHandler .
CLSID_DsQuery
Contiene un puntatore a una struttura DSQUERYINITPARAMS .
clsidDefaultForm
Specifica il modulo predefinito da visualizzare nella finestra di dialogo query. Questo membro viene ignorato se dwFlags non contiene OQWF_DEFAULTFORM. Questo membro può contenere il CLSID di un modulo di query personalizzato o uno dei moduli forniti dal sistema.
CLSID_DsFindAdvanced
Identifica il modulo di query di ricerca personalizzata .
CLSID_DsFindComputer
Identifica il modulo di query Computers .
CLSID_DsFindContainer
Identifica il modulo di query Unità organizzative .
CLSID_DsFindDomainController
Identifica il modulo di query Controller di dominio .
CLSID_DsFindFrsMembers
Identifica il modulo di query Membri FRS .
CLSID_DsFindObjects
Riservato.
CLSID_DsFindPeople
Identifica il modulo di query Utenti, Contatti e Gruppi .
CLSID_DsFindPrinter
Identifica il modulo di query Stampanti .
CLSID_DsFindVolume
Identifica il modulo di query Cartelle condivise .
CLSID_DsFindWriteableDomainController
Identifica il modulo di query Controller di dominio e visualizza controller di dominio scrivibili.
pPersistQuery
Puntatore a un'interfaccia IPersistQuery usata per archiviare e recuperare i dati delle query. Questi dati riguardano la query stessa, non i risultati della query. Se dwFlags contiene OQWF_LOADQUERY, i dati della query vengono ottenuti da questa interfaccia. Se dwFlags contiene OQWF_SAVEQUERY, i dati della query vengono salvati in questa interfaccia.
pFormParameters
Riservato. Puntatore a una struttura o a un'interfaccia che fornisce i dati di inizializzazione dei parametri per il modulo. Il contenuto di questo puntatore è definito dalla classe del modulo specificata dal membro clsidDefaultForm .
ppbFormParameters
Puntatore a un'interfaccia IPropertyBag che fornisce i dati di inizializzazione dei parametri per il modulo. Il contenuto di questo contenitore di proprietà è definito dalla classe del modulo specificata dal membro clsidDefaultForm . I moduli forniti dal sistema seguenti supportano questo membro.
CLSID_DsFindPrinter
Questo modulo ottiene le proprietà seguenti dal contenitore delle proprietà.
| Nome proprietà | Descrizione |
|---|---|
| printName | Contiene il nome iniziale della stampante. |
| printLocation | Contiene la posizione iniziale della stampante. |
| printModel | Contiene il nome del modello iniziale e/o il numero della stampante. |
CLSID_DsFindComputer
Utilizzare questo modulo per specificare i ruoli computer. Il contenitore delle proprietà deve includere computerRole. Usare una combinazione dei valori seguenti per limitare i ruoli inclusi:
| valore | Ruolo |
|---|---|
| 0x0000 | Tutti i ruoli |
| 0x0001 | Workstation o Server |
| 0x0002 | Tutti i controller di dominio |
| 0x0004 | Controller di dominio scrivibili |
| 0x0008 | Controller di dominio di sola lettura |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Server minimo supportato | Windows Server 2008 |
| Intestazione | cmnquery.h |