IOleObject::GetMoniker 메서드(oleidl.h)

아티클
03/05/2024

호출자가 개체에 연결하는 데 사용할 수 있는 포함된 개체의 모니커를 검색합니다.

구문

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

매개 변수

[in] dwAssign

개체에 모니커가 할당되는 방법을 결정합니다. dwAssign 값에 따라 IOleObject::GetMoniker는 다음 중 하나를 수행합니다.

이미 할당된 경우에만 모니커를 가져옵니다.
호출을 충족하기 위해 필요한 경우 모니커를 강제로 할당합니다.
임시 모니커를 가져옵니다.

dwAssign 값은 열거형 OLEGETMONIKER에 지정됩니다.

참고IOleObject::GetMoniker를 호출할 때 OLEGETMONIKER_UNASSIGN 전달할 수 없습니다. 이 값은 IOleObject::GetMoniker를 호출할 때만 유효합니다.

[in] dwWhichMoniker

요청 중인 모니커의 폼을 지정합니다. 가능한 값은 열거형 OLEWHICHMK에서 가져옵니다.

[out] ppmk

개체의 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker 포인터 변수의 주소입니다. 오류가 발생하면 ppmk 를 NULL로 설정해야 합니다. 개체가 IOleObject::GetMoniker에 대한 호출을 받을 때마다 ppmk에서 참조 수를 늘려야 합니다. ppmk로 완료되면 릴리스를 호출하는 것은 호출자의 책임입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다.

설명

IOleObject::GetMoniker 메서드는 개체의 모니커를 반환합니다. IOleObject::SetMoniker와 마찬가지로 이 메서드는 포함된 개체에 대한 링크를 관리하는 컨텍스트에서만 중요하며, 이 경우에도 선택 사항입니다. 개체의 모니커를 개체에 바인딩해야 하는 잠재적인 링크 클라이언트는 이 메서드를 호출하여 해당 모니커를 가져올 수 있습니다. IOleObject::GetMoniker의 기본 구현은 IOleClientSite::GetMoniker를 호출하여 개체가 실행되고 있지 않거나 클라이언트 사이트에 대한 유효한 포인터가 없는 경우 E_UNEXPECTED 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	oleidl.h