CoGetObject 함수(objbase.h)

  • 아티클

표시 이름을 라는 개체를 식별하는 모니커로 변환한 다음 모니커로 식별된 개체에 바인딩합니다.

구문

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

매개 변수

[in] pszName

만들 개체의 표시 이름입니다.

[in, optional] pBindOptions

실제 개체를 만드는 모니커를 만드는 데 사용되는 바인딩 옵션입니다. 자세한 내용은 BIND_OPTS 참조하세요. 이 매개 변수는 NULL일 수 있습니다.

[in] riid

만들 개체에 구현된 인터페이스의 식별자에 대한 참조입니다.

[out] ppv

생성된 개체에서 riid 로 지정된 인터페이스에 대한 포인터의 주소입니다.

반환 값

이 함수는 E_FAIL, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값과 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
 개체가 성공적으로 만들어졌습니다.
MK_E_SYNTAX
 pszName 매개 변수가 올바르게 구성된 표시 이름이 아닙니다.
MK_E_NOOBJECT
 이 모니커로 식별된 개체 또는 이 모니커가 일부인 복합 모니커로 식별된 일부 개체를 찾을 수 없습니다.
MK_E_EXCEEDEDDEADLINE
 pBindOptions에 전달된 BIND_OPTS 구조체에서 지정한 시간 제한 내에서 바인딩 작업을 완료할 수 없습니다.
MK_E_CONNECTMANUALLY
 바인딩 작업에는 최종 사용자의 지원이 필요합니다. 이 값을 반환하는 가장 일반적인 이유는 암호가 필요하거나 플로피를 탑재해야 하기 때문입니다.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 중간 개체를 찾았지만 바인딩 작업을 완료하는 데 필요한 인터페이스를 지원하지 않았습니다. 예를 들어 항목 모니커는 컨테이너가 IOleItemContainer 인터페이스를 지원하지 않는 경우 이 값을 반환합니다.

설명

CoGetObject 는 COM 라이브러리 함수 CreateBindCtx, MkParseDisplayName 및 IMoniker::BindToObject에 대한 호출을 캡슐화합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 objbase.h
라이브러리 Ole32.lib
DLL Ole32.dll

추가 정보

BIND_OPTS