Freigeben über


IDsDisplaySpecifier::GetDisplaySpecifier-Methode (dsclient.h)

Die IDsDisplaySpecifier::GetDisplaySpecifier-Methode bindet an das Anzeigebezeichnerobjekt für eine bestimmte Klasse in Active Directory Domain Services.

Syntax

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

Parameter

[in] pszObjectClass

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der Objektklasse enthält, für die der Anzeigebezeichner abgerufen werden soll.

[in] riid

Enthält den Schnittstellenbezeichner der gewünschten Schnittstelle.

[in, out] ppv

Zeiger auf einen Schnittstellenzeiger, der den Anzeigebezeichner der Objektklasse empfängt.

Rückgabewert

Gibt einen HRESULT-Standardwert zurück, der Folgendes enthält.

Hinweise

Diese Methode verwendet die ADsOpenObject-Funktion , um an das Anzeigebezeichnerobjekt der angegebenen Klasse zu binden. Wenn dies fehlschlägt, wird versucht, eine Bindung an den Anzeigebezeichner im Benutzergebietsschema zu binden. Wenn dies erneut fehlschlägt, wird er an den Anzeigebezeichner im Standardgebietsschema gebunden.

Diese Methode verwendet die Server- und Benutzeranmeldeinformationen, die durch einen vorherigen Aufruf von IDsDisplaySpecifier::SetServer festgelegt wurden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie diese Methode aufgerufen wird.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile dsclient.h
DLL Dsadmin.dll

Weitere Informationen

ADsOpenObject

Anzeigen von Schnittstellen in Active Directory Domain Services

IDsDisplaySpecifier

IDsDisplaySpecifier::SetServer