Struttura DSQUERYINITPARAMS (dsquery.h)

Articolo
08/23/2023

La struttura DSQUERYINITPARAMS descrive i dati usati per inizializzare una finestra di dialogo di esplorazione nella query del servizio directory.

Sintassi

typedef struct {
  DWORD  cbStruct;
  DWORD  dwFlags;
  LPWSTR pDefaultScope;
  LPWSTR pDefaultSaveLocation;
  LPWSTR pUserName;
  LPWSTR pPassword;
  LPWSTR pServer;
} DSQUERYINITPARAMS, *LPDSQUERYINITPARAMS;

Members

cbStruct

Contiene le dimensioni, in byte, di questa struttura.

dwFlags

Contiene un set di flag che definiscono il comportamento della query. Può essere zero o una combinazione di uno o più dei valori seguenti.

DSQPF_ENABLEADMINFEATURES

Usa le funzionalità supportate dagli strumenti di amministrazione del servizio directory, ad esempio Amministrazione Identificatore di visualizzazione per menu di scelta rapida e pagine delle proprietà.

DSQPF_ENABLEADVANCEDFEATURES

Specifica le funzionalità avanzate nell'istanza IDataObject passata ai menu di scelta rapida e alle pagine delle proprietà.

DSQPF_HASCREDENTIALS

I membri pUserName, pPassword e pServer di questa struttura possono specificare i dati relativi a server e credenziali.

DSQPF_NOCHOOSECOLUMNS

Disabilita la voce Scegli colonne nel menu Visualizza della finestra di dialogo Query.

DSQPF_NOSAVE

Rimuove l'elemento Salva ricerca dal menu File della finestra di dialogo query.

DSQPF_SAVELOCATION

Il membro pDefaultSaveLocation contiene il percorso predefinito del file system in cui verranno salvate le ricerche.

DSQPF_SHOWHIDDENOBJECTS

Fa sì che la finestra di dialogo query visualizzi gli oggetti nascosti nell'elenco dei risultati della query.

pDefaultScope

Puntatore a una stringa Unicode con terminazione Null che contiene il percorso ADsPath dell'ambito predefinito per la ricerca. Impostare questo membro su NULL se non viene specificato alcun ambito di ricerca predefinito.

pDefaultSaveLocation

Puntatore a una stringa Unicode con terminazione Null che contiene il percorso predefinito del file system in cui verranno salvate le ricerche. Questo membro viene ignorato se il membro dwFlags non contiene DSQPF_SAVELOCATION.

pUserName

Puntatore a una stringa Unicode con terminazione Null contenente il nome utente nella notazione di dominio valida, ad esempio "fabrikam\jeffsmith".

pPassword

Puntatore a una stringa Unicode con terminazione Null contenente la password dell'utente specificato dal membro pUserName .

pServer

Puntatore a una stringa Unicode con terminazione Null contenente il nome del server da cui viene letto l'elenco di domini attendibili. L'elenco viene utilizzato per popolare l'elenco a discesa In: nella finestra di dialogo.

Commenti

Questa struttura è specifica del gestore di query CLSID_DsQuery . Questa struttura viene utilizzata per il membro pHandlerParameters della struttura OPENQUERYWINDOW quando CLSID_DsQuery viene impostato per il membro clsidHandler della struttura OPENQUERYWINDOW . Per altre informazioni e un esempio di codice per l'uso di questa e altre API correlate, vedere ICommonQuery::OpenQueryWindow.