DSBITEMA structure (dsclient.h)
The DSBITEM structure contains data about an item in the Active Directory container browser dialog box. This structure is passed with the DSBM_QUERYINSERT notification to the BFFCallBack callback function. The container browser dialog box is created with the DsBrowseForContainer function.
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;
Members
cbStruct
Contains the size, in bytes, of the structure.
pszADsPath
Pointer to a null-terminated Unicode string that contains the ADsPath of the item.
pszClass
Pointer to a null-terminated Unicode string that contains the object class name of the item.
dwMask
Contains a set of flags that indicate which members of the structure contain valid data. This can be zero or a combination of one or more of the following values.
DSBF_DISPLAYNAME
The szDisplayName member contains valid data.
DSBF_ICONLOCATION
The szIconLocation and iIconResID members contain valid data.
DSBF_STATE
The dwState and dwStateMask members contain valid data.
dwState
Contains a set of flags that indicate the state of the item. This can be zero or a combination of one or more of the following values.
DSBS_CHECKED
If this flag is set, the item is selected. Otherwise, the item is not selected. This flag is not currently supported.
DSBS_HIDDEN
If this flag is set, the item is hidden. Otherwise, the item is visible.
DSBS_ROOT
If this flag is set, the item is a root item. Otherwise, the item is not a root item.
dwStateMask
Contains a set of flags that indicate which flags in the dwState member contain valid data. This can be zero or a combination of one or more of the following values. For example, if dwStateMask has the DSBS_HIDDEN flag set and dwState does not have the DSBS_HIDDEN flag set, then the item is visible. If dwStateMask does not have the DSBS_HIDDEN flag set, then the DSBS_HIDDEN flag in dwState must be ignored.
DSBS_CHECKED
The DSBS_CHECKED flag in the dwState member contains valid data.
DSBS_HIDDEN
The DSBS_HIDDEN flag in the dwState member contains valid data.
DSBS_ROOT
The DSBS_ROOT flag in the dwState member contains valid data.
szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]
Pointer to a null-terminated string that contains the display name of the item. The display name of an item can be changed by copying the new display name into this member, setting the DSBF_DISPLAYNAME flag in the dwMask member, and returning a nonzero value from BFFCallBack.
szIconLocation[MAX_PATH]
Pointer to a null-terminated string that contains the name of an .exe, .dll, or .ico file that contains the icon to display for the item. This can be any file type that can be passed to the ExtractIcon function. The index for this icon is specified in iIconResID. To modify the icon displayed for the item, copy the icon source file name into this member, set iIconResID to the zero-based index of the icon, set the DSBF_ICONLOCATION flag in the dwMask member, and return a nonzero value from BFFCallBack.
iIconResID
Contains the zero-based index of the icon to display for the item.
Remarks
Note
The dsclient.h header defines DSBITEM as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Header | dsclient.h |