IOleObject::GetMoniker 메서드(oleidl.h)
호출자가 개체에 연결하는 데 사용할 수 있는 포함된 개체의 모니커를 검색합니다.
구문
HRESULT GetMoniker(
[in] DWORD dwAssign,
[in] DWORD dwWhichMoniker,
[out] IMoniker **ppmk
);
매개 변수
[in] dwAssign
개체에 모니커가 할당되는 방법을 결정합니다. dwAssign 값에 따라 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 |