IDsDisplaySpecifier ::GetDisplaySpecifier, méthode (dsclient.h)

Article
02/29/2024

La méthode IDsDisplaySpecifier ::GetDisplaySpecifier est liée à l’objet spécificateur d’affichage pour une classe donnée dans services de domaine Active Directory.

Syntaxe

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

Paramètres

[in] pszObjectClass

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de la classe d’objet pour laquelle récupérer le spécificateur d’affichage.

[in] riid

Contient l’identificateur d’interface de l’interface souhaitée.

[in, out] ppv

Pointeur vers un pointeur d’interface qui reçoit le spécificateur d’affichage de la classe d’objet.

Valeur retournée

Retourne une valeur HRESULT standard, y compris les éléments suivants.

Remarques

Cette méthode utilise la fonction ADsOpenObject pour établir une liaison à l’objet spécificateur d’affichage de la classe donnée. En cas d’échec, il tente de lier au spécificateur d’affichage dans les paramètres régionaux de l’utilisateur. Si cette opération échoue à nouveau, elle est liée au spécificateur d’affichage dans les paramètres régionaux par défaut.

Cette méthode utilise les informations d’identification du serveur et de l’utilisateur définies par un appel précédent à IDsDisplaySpecifier ::SetServer.

Exemples

L’exemple de code suivant montre comment appeler cette méthode.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	dsclient.h
DLL	Dsadmin.dll

Voir aussi

ADsOpenObject

Afficher les interfaces dans services de domaine Active Directory

IDDisplaySpecifier

IDsDisplaySpecifier ::SetServer

Partager via