DSDISPLAYSPECOPTIONS

The DSDISPLAYSPECOPTIONS structure is returned by the clipboard format that is used to specify information to a context menu or property page about the display specifiers being used. It is important for specifying the credentials required by the extension to access information in the Active Directory™.

typedef struct DSDISPLAYSPECOPTIONS 
{
  DWORD  dwSize;
  DWORD  dwFlags;
  DWORD  offsetAttribPrefix;
  DWORD  offsetUserName;
  DWORD  offsetPassword;
  DWORD  offsetServer;
  DWORD  offsetServerConfigPath;
} DSDISPLAYSPECOPTIONS, *PDSDISPLAYSPECOPTIONS, *LPDSDISPLAYSPECOPTIONS;

Members

dwSize

The size of the structure for versioning purposes.

dwFlags

Invocation flags, which can be a combination of flags described in the following table.

Flags	Description
DS_DSOF_DSAVAILABLE	Forces the client to avoid checking if the user is authenticated, the network is present or logged in, assuming the client belongs to an Active Directory domain.
DSDSOF_HASUSERANDSERVERINFO	The offsetUserName, offsetpassword, and other parameters are valid.
DSDSOF_SIMPLEAUTHENTICATE	Do not specify ADS_SECURE_AUTHENTICATION flag when calling ADsOpenObject.

offsetAttribPrefix

Offset to a UNICODE string used to prefix Display Specifier attributes to switch between "admin" and "shell" views, eg: shellContextMenu.

offsetUserName

Offset from the start of the structure to the UNICODE string.

offsetPassword

Offset from the start of the structure to the UNICODE string.

offsetServer

Offset to the server to retrieve the Display Specifiers from.

offsetServerConfigPath

Offset to the server config path (formulated from the server name and other configuration information).

Remarks

When you invoke an object, referenced by a display specifier (context menu, property page, etc.), you must call the IShellExtInit interface, to pass a IDataObject. This data object supports the CF_DSDISPLAYSPECOPTIONS format to provide configuration information about the admin/shell invocation.

When interacting with dsuiext.dll, the interfaces uses this clipboard format to determine which display specifier attributes to address (admin/shell) and pick up the values accordingly. If no format is supported, then dsuiext.dll will default to the shell.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsclient.h.

See Also

Active Directory Display Structures