DSBITEM

The DSBITEM structure holds the information of an item in a directory container to be displayed in a browser dialog boxes created in the DsBrowseForContainer function.

typedef struct DSBITEM 
{
  DWORD  cbStruct;
  LPCWSTR  pszADsPath;
  LPCWSTR  pszClass;
  DWORD  dwMask;
  DWORD  dwState;
  DWORD  dwStateMask;
  WCHAR  szDisplayName [DSB_MAX_DISPLAYNAME_CHARS];
  INT    iIconResID;
} DSBITEM, *PDSBITEM;

Members

cbStruct

The size of the structure.

pszADsPath

ADsPath of the item.

pszClass

Class name of the item.

dwMask

Flags masking the display state, icon location, and display name of the item. It can be a combination of the followings:

dwMask	Value
DSBF_DISPLAYNAME	0x0000004
DSBF_ICONLOCATION	0x0000002
DSBF_STATE	0x0000001

dwState

The display state of the item.

dwStateMask

Flags for the display state of the item. It can be a combination of the following:

dwStateMask	Value
DSBS_CHECKED	0x0000001
DSBS_HIDDEN	0x0000002
DSBS_ROOT	0x0000004

szDisplayName

Display name of the item.

szIconLocation [MAX_PATH]

Icon location of the item.

iIconResID

The resource identifier of the icon of the item.

Remarks

The DSBITEM data structure represents an item in a container for display in the container browser. An item, when selected, is passed in a message to the callback function of the browser dialog through the lParam parameter. This callback function is specified in the DSBROWSEINFO structure which is used by the DsBrowseForContainer function.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsclient.h.
  Unicode: Declared as Unicode and ANSI structures.

See Also

Active Directory Display Structures, DsBrowseForContainer, _BrowseCallBack, DSBROWSEINFO