Struttura DSBITEMA (dsclient.h)

La struttura DSBITEM contiene i dati relativi a un elemento nella finestra di dialogo del browser contenitore di Active Directory. Questa struttura viene passata con la notifica di DSBM_QUERYINSERT alla funzione di callback BFFCallBack. La finestra di dialogo del browser contenitore viene creata con la funzione DsBrowseForContainer .

Sintassi

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  CHAR    szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  CHAR    szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMA, *PDSBITEMA;

Membri

cbStruct

Contiene le dimensioni, in byte, della struttura.

pszADsPath

Puntatore a una stringa Unicode con terminazione Null che contiene l'ADsPath dell'elemento.

pszClass

Puntatore a una stringa Unicode con terminazione Null contenente il nome della classe oggetto dell'elemento.

dwMask

Contiene un set di flag che indicano quali membri della struttura contengono dati validi. Può essere zero o una combinazione di uno o più dei valori seguenti.

DSBF_DISPLAYNAME

Il membro szDisplayName contiene dati validi.

DSBF_ICONLOCATION

I membri szIconLocation e iIconResID contengono dati validi.

DSBF_STATE

I membri dwState e dwStateMas k contengono dati validi.

dwState

Contiene un set di flag che indicano lo stato dell'elemento. Può essere zero o una combinazione di uno o più dei valori seguenti.

DSBS_CHECKED

Se questo flag è impostato, l'elemento viene selezionato. In caso contrario, l'elemento non è selezionato. Questo flag non è attualmente supportato.

DSBS_HIDDEN

Se questo flag è impostato, l'elemento è nascosto. In caso contrario, l'elemento è visibile.

DSBS_ROOT

Se questo flag è impostato, l'elemento è un elemento radice. In caso contrario, l'elemento non è un elemento radice.

dwStateMask

Contiene un set di flag che indicano quali flag nel membro dwState contengono dati validi. Può essere zero o una combinazione di uno o più dei valori seguenti. Ad esempio, se dwStateMask ha il flag DSBS_HIDDEN impostato e dwState non dispone del flag DSBS_HIDDEN impostato, l'elemento è visibile. Se dwStateMask non dispone del flag di DSBS_HIDDEN impostato, il flag DSBS_HIDDEN in dwState deve essere ignorato.

DSBS_CHECKED

Il flag DSBS_CHECKED nel membro dwState contiene dati validi.

DSBS_HIDDEN

Il flag DSBS_HIDDEN nel membro dwState contiene dati validi.

DSBS_ROOT

Il flag DSBS_ROOT nel membro dwState contiene dati validi.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Puntatore a una stringa con terminazione Null contenente il nome visualizzato dell'elemento. Il nome visualizzato di un elemento può essere modificato copiando il nuovo nome visualizzato in questo membro, impostando il flag DSBF_DISPLAYNAME nel membro dwMask e restituendo un valore diverso da zero da BFFCallBack.

szIconLocation[MAX_PATH]

Puntatore a una stringa con terminazione Null contenente il nome di un .exe, .dllo .ico file contenente l'icona da visualizzare per l'elemento. Può trattarsi di qualsiasi tipo di file che può essere passato alla funzione ExtractIcon . L'indice per questa icona viene specificato in iIconResID. Per modificare l'icona visualizzata per l'elemento, copiare il nome del file di origine dell'icona in questo membro, impostare iIconResID sull'indice in base zero dell'icona, impostare il flag DSBF_ICONLOCATION nel membro dwMask e restituire un valore diverso da zero da BFFCallBack.

iIconResID

Contiene l'indice in base zero dell'icona da visualizzare per l'elemento.

Nota Questo non è l'identificatore della risorsa dell'icona.

 

Osservazioni

Nota

L'intestazione dsclient.h definisce DSBITEM 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

BFFCallBack

DsBrowseForContainer

ExtractIcon