Share via

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

추가 정보

ADSI 오류 코드

ADSI 함수

ADsOpenObject

GetObject 및 ADsGetObject를 사용하여 바인딩