IDsDisplaySpecifier：：GetDisplaySpecifier 方法 (dsclient.h)

發行項
02/29/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();
}