Platform SDK: Active Directory, ADSI, and Directory Services

IDsDisplaySpecifier::GetDisplaySpecifier

The IDsDisplaySpecifier::GetDisplaySpecifier method binds to the display specifier for a given class in an Active Directory™ store.

HRESULT GetDisplaySpecifier(
  LPCWSTR pszObjectClass,
  REFIID riid,
  VOID **ppv
);

Parameters

pszObjectClass
[in] Name of an object class.
riid
[in] Interface identifier.
**ppv
[in, out] Pointer to the display specifier of the object class given above.

Return Values

This method returns an HRESULT value.

Remarks

This method calls the ADsOpenObject function to bind to the display specifier of the given class. If that fails, it attempts to bind to the display specifier in the user locale. If this fails again, it binds to the display specifier in the default locale It uses the server and user credentials set by a previous call to IDsDisplaySpecifier::SetServer.

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, ADsOpenObject, IDsDisplaySpecifier, IDsDisplaySpecifier::SetServer