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 specifier stores data 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.

This interface is used to extend the display features of an existing Active Directory object, manage the display for a new directory object, or enhance the display of an Active Directory enabled application. For more information, see Extending the User Interface for Directory Objects.

To create an instance of this interface, call CoCreateInstance with the CLSID_DsDisplaySpecifier object identifier as shown in the following code example. 
[C++]
#include <objbase.h>
#define INITGUID
#include <initguid.h>
#include "dsclient.h"
 
HRESULT hr;
IDsDisplaySpecifier *pDS;

CoInitialize(NULL);

hr = CoCreateInstance( CLSID_DsDisplaySpecifier,
					 NULL,
					 CLSCTX_INPROC_SERVER,
					 IID_IDsDisplaySpecifier,
					 (void**)&pDS);
if(SUCCEEDED(hr))
{
	// More code calling the interface methods.

	pDS->Release();
}
 
CoUninitialize();

Methods in Vtable Order

The IDsDisplaySpecifier interface inherits the methods of the standard COM interface IUnknown.

In addition, IDsDisplaySpecifier defines the following methods.

Method Description
SetServer Specifies the server from which display specifier data is obtained.
SetLanguageID Changes the locale used by the IDsDisplaySpecifier object to a specified language.
GetDisplaySpecifier Binds to the display specifier object for a given class in Active Directory.
GetIconLocation Obtains the icon location for a given object class.
GetIcon Obtains the icon for a given object class.
GetFriendlyClassName Obtains the localized name for an object class.
GetFriendlyAttributeName Obtains the localized name of an attribute of a given object class.
IsClassContainer Determines if a given object class is a container.
GetClassCreationInfo Obtains data about the class creation wizard objects for a given object class.
EnumClassAttributes Enumerates the attributes for a given object class.
GetAttributeADsType Obtains the attribute type for a given attribute.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsclient.h.

See Also

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