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 도입) |