ADsGetObject 函式 (adshlp.h)

  • 發行項

ADsGetObject 函式會根據其路徑和指定的介面標識符系結至物件。

語法

HRESULT ADsGetObject(
  [in]  LPCWSTR lpszPathName,
  [in]  REFIID  riid,
  [out] VOID    **ppObject
);

參數

[in] lpszPathName

類型： LPCWSTR

Null 終止的 Unicode 字串，指定用來系結至基礎目錄服務中對象的路徑。 如需此參數係結字串的詳細資訊和程式代碼範例，請參閱 LDAP ADsPath 和 WinNT ADsPath。

[in] riid

類型： REFIID

這個物件上指定介面的介面標識碼。

[out] ppObject

類型： VOID**

指向所要求介面之指標的指標。

傳回值

類型： HRESULT

這個方法支持標準 HRESULT 傳回值，以及下列專案。

如需其他傳回值的詳細資訊，請參閱 ADSI 錯誤碼。

備註

C/C++ 用戶端會呼叫 ADsGetObject 協助程式函式，以系結至 ADSI 物件。 它相當於呼叫 GetObject 函式的 Visual Basic 用戶端。 它們都會接受 ADsPath 做為輸入，並傳回所要求介面的指標。 根據預設，系結會使用 ADS_SECURE_AUTHENTICATION 選項搭配呼叫線程的安全性內容。 不過，如果驗證失敗，安全系結會降級為匿名系結，例如，沒有使用者認證的簡單系結。 若要安全地系結至 ADSI 物件，請使用 ADsOpenObject 函式，而不是 ADsGetObject 函式。

如需示範如何使用 ADsOpenObject 的程式代碼範例，請參閱 使用 GetObject 和 ADsGetObject 系結。

您可以繫結至 ADSI 物件，其使用者認證與目前登入的使用者認證不同。 若要執行這項作業，請使用 ADsOpenObject 函式。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 adshlp.h
程式庫 Activeds.lib
Dll Activeds.dll

另請參閱

ADSI 錯誤碼

ADSI 函式

ADsOpenObject

使用 GetObject 和 ADsGetObject 進行系結