ADsGetObject 함수(adshlp.h)
ADsGetObject 함수는 해당 경로와 지정된 인터페이스 식별자가 지정된 개체에 바인딩됩니다.
구문
HRESULT ADsGetObject(
[in] LPCWSTR lpszPathName,
[in] REFIID riid,
[out] VOID **ppObject
);
매개 변수
[in] lpszPathName
형식: LPCWSTR
기본 디렉터리 서비스의 개체에 바인딩하는 데 사용되는 경로를 지정하는 null로 종료된 유니코드 문자열입니다. 이 매개 변수에 대한 문자열 바인딩에 대한 자세한 내용 및 코드 예제는 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 개체에 안전하게 바인딩하려면 ADsGetObject 함수 대신 ADsOpenObject 함수를 사용합니다.
ADsOpenObject를 사용하는 방법을 보여 주는 코드 예제는 GetObject 및 ADsGetObject를 사용하여 바인딩을 참조하세요.
현재 로그온한 사용자의 자격 증명과 다른 사용자 자격 증명을 사용하여 ADSI 개체에 바인딩할 수 있습니다. 이 작업을 수행하려면 ADsOpenObject 함수를 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | adshlp.h |
| 라이브러리 | Activeds.lib |
| DLL | Activeds.dll |