IDsDisplaySpecifier：：GetDisplaySpecifier 方法 (dsclient.h)

项目
02/26/2024

IDsDisplaySpecifier：：GetDisplaySpecifier 方法绑定到Active Directory 域服务中给定类的显示说明符对象。

语法

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

参数

[in] pszObjectClass

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要检索其显示说明符的对象类的名称。

[in] riid

包含所需接口的接口标识符。

[in, out] ppv

指向接收对象类的显示说明符的接口指针的指针。

返回值

返回一个标准 HRESULT 值，其中包括以下内容。

注解

此方法使用 ADsOpenObject 函数绑定到给定类的显示说明符对象。如果失败，它将尝试绑定到用户区域设置中的显示说明符。如果再次失败，它将绑定到默认区域设置中的显示说明符。

此方法使用先前调用 IDsDisplaySpecifier：：SetServer 设置的服务器和用户凭据。

示例

下面的代码示例演示如何调用此方法。

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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	dsclient.h
DLL	Dsadmin.dll