Platform SDK: Active Directory, ADSI, and Directory Services

IDsDisplaySpecifier

The IDsDisplaySpecifier interface provides access to Active Directory™ objects of the displaySpecifier class. Such objects are known as display specifiers. A display specifiers stores the information about how user interface elements, such as property pages or context menus, of an Active Directory object are to be displayed. For more information, see Display Specifiers. Using this interface, you can extend the display features of an existing Active Directory object or manage the display for a new directory object . For more information, see Extending the User Interface for Directory Objects.

The IDsDisplaySpecifier interface is implemented on a DsDisplaySpecifier object and distributed in dsuiext.dll. To use the interface, you must first create an instance of the DsDisplaySpecifier object class:

#include <objbase.h>
#define INITGUID
#include <initguid.h>
#include "dsclient.h"
 
IDsBrowseDomainTree *pDS;
CoInitialize(NULL);
IDsDisplaySpecifier *pDS;
HRESULT hr = CoCreateInstance(CLSID_DsDisplaySpecifier,
                           NULL,
                           CLSCTX_INPROC_SERVER,
                           IID_IDsDisplaySpecifier,
                           (void**)&pDS);
// More code calling the interface methods …
 
pDSB->Release();
CoUninitialize();

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IDsDisplaySpecifier Methods Description
SetServer Sets a server.
SetLanguageID Sets the locale.
GetDisplaySpecifier Retrieves a displaySpecifier object from an Active Directory server.
GetIconLocation Retrieves the location on which an icon is to be displayed in a UI.
GetIcon Retrieves the icon to be displayed in a UI.
GetFriendlyClassName Gets the friendly class name.
GetFriendlyAttributeName Gets the friendly attribute name.
IsClassContainer Tests if a class is a container.
GetClassCreationInfo Retrieves the property sheets of a class creation wizard.
EnumClassAttributes Enumerates class attributes.
GetAttributeADsType Retrieves attribute types.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsclient.h.
  Library: Included as a resource in Dsuiext.dll.

See Also

Active Directory Display Interfaces, ICommonQuery, IDsBrowseDomainTree, IPersistQuery, IQueryForm