DSBITEMA-Struktur (dsclient.h)

Die DSBITEM-Struktur enthält Daten zu einem Element im Dialogfeld Active Directory-Containerbrowser. Diese Struktur wird mit der DSBM_QUERYINSERT Benachrichtigung an die BFFCallBack-Rückruffunktion übergeben. Das Dialogfeld Containerbrowser wird mit der Funktion DsBrowseForContainer erstellt.

Syntax

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;

Member

cbStruct

Enthält die Größe der Struktur in Bytes.

pszADsPath

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den ADsPath des Elements enthält.

pszClass

Zeiger auf eine mit NULL beendete Unicode-Zeichenfolge, die den Objektklassennamen des Elements enthält.

dwMask

Enthält eine Reihe von Flags, die angeben, welche Elemente der Struktur gültige Daten enthalten. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DSBF_DISPLAYNAME

Das szDisplayName-Element enthält gültige Daten.

DSBF_ICONLOCATION

Die Member szIconLocation und iIconResID enthalten gültige Daten.

DSBF_STATE

Die DwState - und dwStateMask-Member enthalten gültige Daten.

dwState

Enthält eine Reihe von Flags, die den Status des Elements angeben. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DSBS_CHECKED

Wenn dieses Flag festgelegt ist, wird das Element ausgewählt. Andernfalls wird das Element nicht ausgewählt. Dieses Flag wird derzeit nicht unterstützt.

DSBS_HIDDEN

Wenn dieses Flag festgelegt ist, wird das Element ausgeblendet. Andernfalls ist das Element sichtbar.

DSBS_ROOT

Wenn dieses Flag festgelegt ist, ist das Element ein Stammelement. Andernfalls ist das Element kein Stammelement.

dwStateMask

Enthält eine Reihe von Flags, die angeben, welche Flags im dwState-Member gültige Daten enthalten. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein. Wenn bei dwStateMask beispielsweise das DSBS_HIDDEN-Flag festgelegt ist und dwState nicht das DSBS_HIDDEN-Flag festgelegt ist, ist das Element sichtbar. Wenn für dwStateMask das DSBS_HIDDEN-Flag nicht festgelegt ist, muss das DSBS_HIDDEN-Flag in dwState ignoriert werden.

DSBS_CHECKED

Das DSBS_CHECKED-Flag im dwState-Member enthält gültige Daten.

DSBS_HIDDEN

Das DSBS_HIDDEN-Flag im dwState-Member enthält gültige Daten.

DSBS_ROOT

Das DSBS_ROOT-Flag im dwState-Member enthält gültige Daten.

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

Zeiger auf eine NULL-Zeichenfolge, die den Anzeigenamen des Elements enthält. Der Anzeigename eines Elements kann geändert werden, indem sie den neuen Anzeigenamen in dieses Element kopieren, das DSBF_DISPLAYNAME-Flag im dwMask-Element festlegen und einen nonzero-Wert aus BFFCallBack zurückgeben.

szIconLocation[MAX_PATH]

Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen einer .exe, .dll oder .ico Datei enthält, die das symbol enthält, das für das Element angezeigt werden soll. Dies kann ein beliebiger Dateityp sein, der an die ExtractIcon-Funktion übergeben werden kann. Der Index für dieses Symbol wird in iIconResID angegeben. Um das für das Element angezeigte Symbol zu ändern, kopieren Sie den Namen der Quelldatei des Symbols in dieses Element, legen Sie iIconResID auf den nullbasierten Index des Symbols fest, legen Sie das DSBF_ICONLOCATION-Flag im dwMask-Element fest, und geben Sie einen wert von BFFCallBack zurück.

iIconResID

Enthält den nullbasierten Index des Symbols, das für das Element angezeigt werden soll.

Hinweis Dies ist nicht der Ressourcenbezeichner des Symbols.

 

Hinweise

Hinweis

Der dsclient.h-Header definiert DSBITEM als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	dsclient.h

Weitere Informationen

BFFCallBack

DsBrowseForContainer

ExtractIcon