Struttura DSBITEMA (dsclient.h)

La struttura DSBITEM contiene dati relativi a un elemento nella finestra di dialogo Del browser contenitori 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;

Members

cbStruct

Contiene le dimensioni, in byte, della struttura.

pszADsPath

Puntatore a una stringa Unicode con terminazione null contenente 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. Questo 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 dwStateMask contengono dati validi.

dwState

Contiene un set di flag che indicano lo stato dell'elemento. Questo 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. Questo 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 ha il flag DSBS_HIDDEN impostato, l'elemento è visibile. Se dwStateMask non dispone del flag DSBS_HIDDEN impostato, il flag di 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 ZeroBack.

szIconLocation[MAX_PATH]

Puntatore a una stringa con terminazione null contenente il nome di un .exe, .dll o .ico file che contiene l'icona da visualizzare per l'elemento. Questo può essere 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 di 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 Non è l'identificatore della risorsa dell'icona.

 

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	dsclient.h

Vedi anche

BFFCallBack

DsBrowseForContainer

ExtractIcon