다음을 통해 공유


ADsGetObject 함수(adshlp.h)

ADsGetObject 함수는 해당 경로와 지정된 인터페이스 식별자가 지정된 개체에 바인딩됩니다.

구문

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

매개 변수

[in] lpszPathName

형식: LPCWSTR

기본 디렉터리 서비스의 개체에 바인딩하는 데 사용되는 경로를 지정하는 null로 종료된 유니코드 문자열입니다. 이 매개 변수에 대한 문자열 바인딩에 대한 자세한 내용 및 코드 예제는 LDAP ADsPathWinNT 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

추가 정보

ADSI 오류 코드

ADSI 함수

ADsOpenObject

GetObject 및 ADsGetObject를 사용하여 바인딩