Compartir a través de

Método IDsDisplaySpecifier::GetDisplaySpecifier (dsclient.h)

  • Artículo

El método IDsDisplaySpecifier::GetDisplaySpecifier se enlaza al objeto de especificador de visualización para una clase determinada en Servicios de dominio de Active Directory.

Sintaxis

HRESULT GetDisplaySpecifier(
  [in]      LPCWSTR pszObjectClass,
  [in]      REFIID  riid,
  [in, out] void    **ppv
);

Parámetros

[in] pszObjectClass

Puntero a una cadena Unicode terminada en null que contiene el nombre de la clase de objeto para la que se va a recuperar el especificador de visualización.

[in] riid

Contiene el identificador de interfaz de la interfaz deseada.

[in, out] ppv

Puntero a un puntero de interfaz que recibe el especificador de presentación de la clase de objeto.

Valor devuelto

Devuelve un valor HRESULT estándar, incluido lo siguiente.

Comentarios

Este método usa la función ADsOpenObject para enlazar al objeto especificador de visualización de la clase especificada. Si se produce un error, intenta enlazar al especificador de pantalla en la configuración regional del usuario. Si se produce un error de nuevo, se enlaza al especificador de presentación en la configuración regional predeterminada.

Este método usa el servidor y las credenciales de usuario establecidas por una llamada anterior a IDsDisplaySpecifier::SetServer.

Ejemplos

En el ejemplo de código siguiente se muestra cómo llamar a este método.

HRESULT hr;
IDsDisplaySpecifier *pDS;

hr = CoCreateInstance(CLSID_DsDisplaySpecifier,
                        NULL,
                        CLSCTX_INPROC_SERVER,
                        IID_IDsDisplaySpecifier,
                        (void**)&pDS);
if(SUCCEEDED(hr))
{
    IADs *pads;

    hr = pDS->GetDisplaySpecifier(L"user", IID_IADs, (LPVOID*)&pads);

    if(SUCCEEDED(hr))
    {
        pads->Release();
    }

    pDS->Release();
}

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado dsclient.h
Archivo DLL Dsadmin.dll

Consulte también

ADsOpenObject

Mostrar interfaces en Servicios de dominio de Active Directory

IDsDisplaySpecifier

IDsDisplaySpecifier::SetServer