CreateItemMoniker 함수(objbase.h)

  • 아티클

포함하는 개체(일반적으로 복합 문서) 내에서 개체를 식별하는 항목 모니커를 만듭니다.

구문

HRESULT CreateItemMoniker(
  [in]  LPCOLESTR lpszDelim,
  [in]  LPCOLESTR lpszItem,
  [out] LPMONIKER *ppmk
);

매개 변수

[in] lpszDelim

이 항목의 표시 이름을 포함하는 개체의 표시 이름과 구분 기호(일반적으로 "!")를 포함하는 0으로 끝나는 와이드 문자열(문자당 2바이트)에 대한 포인터입니다.

[in] lpszItem

식별되는 개체의 포함하는 개체 이름을 나타내는 0으로 끝나는 문자열에 대한 포인터입니다. 이 이름은 나중에 IOleItemContainer::GetObject 호출에서 개체에 대한 포인터를 검색하는 데 사용할 수 있습니다.

[out] ppmk

항목 모니커에 대한 인터페이스 포인터를 수신하는 IMoniker* 포인터 변수의 주소입니다. 성공하면 함수는 항목 모니커에서 AddRef 를 호출하고 호출자는 Release를 호출합니다. 오류가 발생하면 제공된 인터페이스 포인터에 NULL 값이 있습니다.

반환 값

이 함수는 E_OUTOFMEMORY 및 S_OK 표준 반환 값을 반환할 수 있습니다.

설명

모니커 공급자는 모니커를 전달하여 다른 당사자가 액세스할 수 있도록 개체를 식별하며 CreateItemMoniker 를 호출하여 항목 모니커로 개체를 식별합니다. 항목 모니커 는 문자열을 기반으로 하며 다른 개체 내에 포함되고 문자열을 사용하여 개별적으로 식별할 수 있는 개체를 식별합니다. 포함하는 개체는 IOleContainer 인터페이스도 구현해야 합니다.

대부분의 모니커 공급자는 연결을 지원하는 OLE 애플리케이션입니다. 파일 기반 문서보다 작은 개체에 대한 연결을 지원하는 애플리케이션(예: 문서 내의 선택 영역에 연결할 수 있는 서버 애플리케이션)은 항목 모니커를 사용하여 개체를 식별해야 합니다. 포함된 개체에 연결할 수 있는 컨테이너 애플리케이션은 항목 모니커를 사용하여 포함된 개체를 식별합니다.

lpszItem 매개 변수는 문서에서 개체를 고유하게 식별하는 데 사용하는 이름입니다. 예를 들어 식별되는 개체가 스프레드시트의 셀 범위인 경우 적절한 이름은 "A1:E7"일 수 있습니다. 식별되는 개체가 포함된 개체인 경우 적절한 이름은 "embedobj1"와 같을 수 있습니다. 포함하는 개체는 이 이름을 해석하고 해당 개체를 찾을 수 있는 IOleItemContainer 인터페이스의 구현을 제공해야 합니다. 이렇게 하면 항목 모니커가 식별되는 개체에 바인딩될 수 있습니다.

항목 모니커가 격리된 상태로 사용되지 않습니다. 포함하는 개체도 식별하는 모니커로 구성되어야 합니다. 예를 들어 식별되는 개체가 파일 기반 문서에 포함된 셀 범위인 경우 해당 개체를 식별하는 항목 모니커는 해당 문서를 식별하는 파일 모니커로 구성되어야 하므로 "C:\work\sales.xls! A1:E7."

개체가 다른 문서 내에 포함된 개체 내에 포함된 경우와 마찬가지로 중첩된 컨테이너도 허용됩니다. 이러한 개체의 전체 모니커는 "C:\work\report.doc!embedobj1! A1:E7." 이 경우 개체를 포함하는 각 개체는 CreateItemMoniker 를 호출하고 IOleItemContainer 인터페이스의 자체 구현을 제공해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 objbase.h
라이브러리 Ole32.lib
DLL Ole32.dll
API 세트 ext-ms-win-com-ole32-l1-1-0(Windows 8 도입)

추가 정보

Imoniker

IMoniker::ComposeWith

IOleContainer

IOleItemContainer