Struttura DSBROWSEINFOA (dsclient.h)

Articolo
11/20/2024

La struttura DSBROWSEINFO viene utilizzata con la funzione DsBrowseForContain er per fornire e restituire dati sulla finestra di dialogo del browser contenitore di Active Directory.

Sintassi

typedef struct {
  DWORD       cbStruct;
  HWND        hwndOwner;
  LPCSTR      pszCaption;
  LPCSTR      pszTitle;
  LPCWSTR     pszRoot;
  LPWSTR      pszPath;
  ULONG       cchPath;
  DWORD       dwFlags;
  BFFCALLBACK pfnCallback;
  LPARAM      lParam;
  DWORD       dwReturnFormat;
  LPCWSTR     pUserName;
  LPCWSTR     pPassword;
  LPWSTR      pszObjectClass;
  ULONG       cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;

Membri

cbStruct

Contiene le dimensioni, in byte, della struttura DSBROWSEINFO . Viene usato dalla funzione DsBrowseForContainer per scopi di controllo delle versioni.

hwndOwner

Handle della finestra utilizzata come elemento padre della finestra di dialogo del browser contenitore.

pszCaption

Puntatore a una stringa con terminazione Null contenente la didascalia della finestra di dialogo. Se questo membro è NULL, viene usata una didascalia predefinita.

pszTitle

Puntatore a una stringa con terminazione Null contenente testo aggiuntivo da visualizzare nella finestra di dialogo sopra il controllo albero. Se questo membro è NULL, non viene visualizzato alcun testo aggiuntivo.

pszRoot

Puntatore a una stringa Unicode con terminazione Null che contiene l'ADsPath del contenitore posizionato nella radice della finestra di dialogo. L'utente non può spostarsi al di sopra di questo livello usando la finestra di dialogo.

pszPath

Puntatore a una stringa Unicode con terminazione Null che riceve l'ADsPath del contenitore selezionato nella finestra di dialogo. Questa stringa verrà sempre terminata con null anche se cchPath non è sufficientemente grande da contenere l'intero percorso. Se dwFlags contiene il flag DSBI_EXPANDONOPEN, questo membro contiene l'ADsPath del contenitore che deve essere inizialmente selezionato nella finestra di dialogo.

cchPath

Contiene le dimensioni, in caratteri di WCHAR, del buffer pszPath .

dwFlags

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

DSBI_NOBUTTONS (1 (0x1))

I pulsanti + e - non vengono visualizzati nella finestra di dialogo.

DSBI_NOLINES (2 (0x2))

Le righe che connettono gli oggetti nella finestra di dialogo non vengono visualizzate.

DSBI_NOLINESATROOT (4 (0x4))

Le righe e i pulsanti sopra gli oggetti radice non vengono visualizzati.

DSBI_CHECKBOXES (256 (0x100))

Fa sì che una casella di controllo venga posizionata accanto a ogni elemento nell'albero. L'utente può usare il mouse per selezionare e deselezionare questa casella di controllo. Questo utilizzo è attualmente limitato perché non è possibile impostare o ottenere lo stato di controllo di un elemento.

DSBI_NOROOT (65536 (0x10000))

L'oggetto radice, specificato da pszRoot, non viene visualizzato e gli oggetti figlio immediati della radice vengono visualizzati nella radice dell'albero. Questo flag non ha alcun effetto se pszRoot è NULL o se questo membro contiene DSBI_ENTIREDIRECTORY.

DSBI_INCLUDEHIDDEN (131072 (0x20000))

Includere oggetti nascosti nella finestra di dialogo.

DSBI_EXPANDONOPEN (262144 (0x40000))

Quando si apre la finestra di dialogo, il contenitore specificato in pszPath sarà visibile e selezionato.

DSBI_ENTIREDIRECTORY (589824 (0x90000))

Include tutti i domini attendibili per il server specificato in pszRoot o, per impostazione predefinita, il dominio a cui l'utente ha eseguito l'accesso.

DSBI_RETURN_FORMAT (1048576 (0x100000))

Indica che il membro dwReturnFormat è valido. Se questo flag non è impostato, per impostazione predefinita il formato del percorso è X.500.

DSBI_HASCREDENTIALS (2097152 (0x200000))

pUserName e pPassword vengono usati per le credenziali di accesso. In caso contrario, se questo membro non contiene DSBI_SIMPLEAUTHENTICATE, la finestra di dialogo usa il contesto di sicurezza del thread chiamante.

DSBI_IGNORETREATASLEAF (4194304 (0x400000))

Quando si determina se l'oggetto viene visualizzato nella finestra di dialogo, l'identificatore di visualizzazione treatAsLeaf viene ignorato.

DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))

Indica che l'autenticazione sicura non è necessaria quando si chiama ADsOpenObject.

DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))

Indica che i pszObjectClass e cchObjectClass sono validi e devono essere compilati.

DSBI_DONTSIGNSEAL (33554432 (0x2000000))

Indica che la firma e la chiusura non verranno utilizzate durante la comunicazione con il servizio directory.

pfnCallback

Puntatore a un definito dall'applicazione BFFCallBack funzione di callback che riceve notifiche dalla finestra di dialogo del browser contenitore. Impostare questo membro su NULL se non viene utilizzato.

lParam

Contiene un valore a 32 bit definito dall'applicazione passato come parametro lpData in tutte le chiamate a pfnCallback. Questo membro viene ignorato se pfnCallback è NULL.

dwReturnFormat

Contiene uno dei valori di ADS_FORMAT_ENUM che specifica il formato che il percorso ADSI restituito in pszPath accetterà.

pUserName

Puntatore a una stringa Unicode che contiene il nome utente usato per le credenziali. Questo membro viene ignorato se dwFlags non dispone del flag DSBI_HASCREDENTIALS impostato. Se questo membro è NULL, viene utilizzato il nome utente attualmente connesso.

pPassword

Puntatore a una stringa Unicode contenente la password usata per le credenziali. Questo membro viene ignorato se dwFlags non dispone del flag DSBI_HASCREDENTIALS impostato. Se questo membro è NULL, viene usata la password dell'utente attualmente connesso.

pszObjectClass

Puntatore a un buffer di stringa Unicode che riceve la stringa di classe dell'oggetto selezionato. Questo membro viene ignorato se dwFlags non dispone del flag DSBI_RETURNOBJECTCLASS impostato.

cchObjectClass

Contiene le dimensioni, in caratteri di WCHAR, del buffer pszObjectClass .

Osservazioni

Nota

L'intestazione dsclient.h definisce DSBROWSEINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
intestazione	dsclient.h

Vedere anche

Condividi tramite