Metodo IDsDisplaySpecifier::GetDisplaySpecifier (dsclient.h)

Articolo
02/29/2024

Il metodo IDsDisplaySpecifier::GetDisplaySpecifier associa all'oggetto identificatore di visualizzazione per una determinata classe in Active Directory Domain Services.

Sintassi

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

Parametri

[in] pszObjectClass

Puntatore a una stringa Unicode con terminazione null contenente il nome della classe oggetto per recuperare l'identificatore di visualizzazione per.

[in] riid

Contiene l'identificatore dell'interfaccia dell'interfaccia desiderata.

[in, out] ppv

Puntatore a un puntatore dell'interfaccia che riceve l'identificatore di visualizzazione della classe oggetto.

Valore restituito

Restituisce un valore HRESULT standard, incluso quanto segue.

Commenti

Questo metodo usa la funzione ADsOpenObject per associare all'oggetto identificatore di visualizzazione della classe specificata. In caso contrario, tenta di associare l'identificatore di visualizzazione nelle impostazioni locali dell'utente. In caso di errore, viene associato all'identificatore di visualizzazione nelle impostazioni locali predefinite.

Questo metodo usa il server e le credenziali utente impostate da una chiamata precedente a IDDisplaySpecifier::SetServer.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare questo metodo.

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();
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsclient.h
DLL	Dsadmin.dll