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 |