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;

Angehörige

cbStruct

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

pszADsPath

Zeigen Sie auf eine mit Null beendete Unicode-Zeichenfolge, die den ADsPath des Elements enthält.

pszClass

Zeigen Sie 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 Member enthält gültige Daten.

DSBF_ICONLOCATION

Die szIconLocation und iIconResID Member enthalten gültige Daten.

DSBF_STATE

Die dwState und dwStateMask-elemente 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 Kennzeichen festgelegt ist, wird das Element ausgewählt. Andernfalls ist das Element nicht ausgewählt. Dieses Flag wird derzeit nicht unterstützt.

DSBS_HIDDEN

Wenn diese Kennzeichnung festgelegt ist, wird das Element ausgeblendet. Andernfalls ist das Element sichtbar.

DSBS_ROOT

Wenn dieses Kennzeichen 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 beispielsweise dwStateMask das DSBS_HIDDEN Flag festgelegt hat und dwState- nicht über das DSBS_HIDDEN Flag festgelegt ist, ist das Element sichtbar. Wenn dwStateMask nicht das DSBS_HIDDEN Flag festgelegt hat, 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]

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Anzeigenamen des Elements enthält. Der Anzeigename eines Elements kann geändert werden, indem der neue Anzeigename in dieses Element kopiert wird, das DSBF_DISPLAYNAME Flag im dwMask Member festgelegt und ein Wert ungleich Null aus BFFCallBack-zurückgegeben wird.

szIconLocation[MAX_PATH]

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen einer .exe, .dlloder .ico Datei enthält, die das Symbol enthält, das für das Element angezeigt werden soll. Dies kann jeder 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 Symbolquelldatei in dieses Element, legen Sie iIconResID auf den nullbasierten Index des Symbols fest, legen Sie das DSBF_ICONLOCATION Flag im dwMask Member fest, und geben Sie einen Nonzero-Wert aus BFFCallBackzurück.

iIconResID

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

Bemerkungen

Anforderungen

Siehe auch

BFFCallBack-

DsBrowseForContainer-

ExtractIcon