Funzione DsBrowseForContainerA (dsclient.h)

Articolo
11/20/2024

La funzione DsBrowseForContainer visualizza una finestra di dialogo usata per cercare gli oggetti contenitore in Servizi di dominio Active Directory.

Sintassi

int DsBrowseForContainerA(
  [in] PDSBROWSEINFOA pInfo
);

Parametri

[in] pInfo

Puntatore a una struttura DSBROWSEINFO che contiene dati sull'inizializzazione della finestra di dialogo del browser contenitore e riceve dati sull'oggetto selezionato.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Osservazioni

Nella finestra di dialogo viene visualizzata una selezione contenitori popolata con contenitori di una determinata radice o che usa domini attendibili. Se usa domini attendibili, può usare il dominio a cui l'utente è attualmente connesso oppure può usare un dominio alternativo specificato dall'applicazione usando il pszRoot membro del struttura DSBROWSEINFO. Se l'utente fa clic sul pulsante di OK o fa doppio clic su un oggetto, viene restituito IDOK e pszPath contiene l'ADsPath dell'oggetto selezionato. Se l'utente annulla la finestra di dialogo, DsBrowseForContainer restituisce IDCANCEL.

Il membro pszRoot contiene un ADsPath, che richiede il modulo seguente.

LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com

DsBrowseForContainer usa questo percorso come radice dell'albero. Il membro pszRoot può essere usato anche per specificare un dominio con un trust con il dominio a cui l'utente è connesso, in modo che l'utente possa esplorare il contenitore Users del dominio alternativo. Se il membro pszPath contiene un percorso, la finestra di dialogo passerà da pszRoot attraverso i contenitori fino a raggiungere l'oggetto specificato da pszPath.

La funzione di DsBrowseForContainer supporta una funzione di callback come specificato nella struttura DSBROWSEINFO . La funzione di callback può essere usata per filtrare, modificare o aggiornare la visualizzazione in base alla modifica della selezione e così via. Per altre informazioni, vedere BFFCallBack.

Importante A partire da Windows Server 2003, la versione ANSI di questa funzione (DsBrowseForContainerA) non viene implementata e restituisce sempre -1.

Esempi

Nell'esempio di codice seguente viene scelto un contenitore nel dominio a cui l'utente ha eseguito l'accesso. La visualizzazione visualizza anche tutti i domini attendibili.

void PickContainer(void)
{
    DSBROWSEINFOW dsbi = { 0 };
    WCHAR wszResult[MAX_PATH];
 
    dsbi.cbStruct = sizeof(dsbi);
    dsbi.pszCaption = L"The container picker";
    dsbi.pszTitle = L"Pick a container for this example.";
    dsbi.pszPath = wszResult;
    dsbi.cchPath = MAX_PATH;
    dsbi.dwFlags = DSBI_ENTIREDIRECTORY;

    int nReturn = DsBrowseForContainerW(&dsbi);
 
    if ( IDOK == nReturn )
    {
        // wszResult contains the resulting path
    }
}

Nota

L'intestazione dsclient.h definisce DsBrowseForContainer 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
piattaforma di destinazione	Finestre
intestazione	dsclient.h
libreria	Dsuiext.lib
dll	Dsuiext.dll

Vedere anche

BFFCallBack

DSBROWSEINFO

Condividi tramite