共用方式為


ADsGetObject 函式 (adshlp.h)

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

語法

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

參數

[in] lpszPathName

類型: LPCWSTR

Null 終止的 Unicode 字串,指定用來系結至基礎目錄服務中對象的路徑。 如需此參數係結字串的詳細資訊和程式代碼範例,請參閱 LDAP ADsPathWinNT 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 進行系結