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

Artigo
02/26/2024

O método IDsDisplaySpecifier::GetDisplaySpecifier é associado ao objeto especificador de exibição para uma determinada classe em Active Directory Domain Services.

Sintaxe

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

Parâmetros

[in] pszObjectClass

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da classe de objeto para a qual recuperar o especificador de exibição.

[in] riid

Contém o identificador de interface da interface desejada.

[in, out] ppv

Ponteiro para um ponteiro de interface que recebe o especificador de exibição da classe de objeto.

Retornar valor

Retorna um valor HRESULT padrão, incluindo o seguinte.

Comentários

Esse método usa a função ADsOpenObject para associar ao objeto especificador de exibição da classe fornecida. Se isso falhar, ele tentará associar ao especificador de exibição na localidade do usuário. Se isso falhar novamente, ele será associado ao especificador de exibição na localidade padrão.

Esse método usa as credenciais do servidor e do usuário definidas por uma chamada anterior para IDsDisplaySpecifier::SetServer.

Exemplos

O exemplo de código a seguir demonstra como chamar esse 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	dsclient.h
DLL	Dsadmin.dll