ITfRange::GetEmbedded 메서드(msctf.h)

아티클
08/24/2023

ITfRange::GetEmbedded 메서드는 텍스트 스트림의 TS_CHAR_EMBEDDED 문자에 해당하는 콘텐츠를 가져옵니다. 텍스트 범위의 시작 앵커는 관심 있는 문자 바로 앞에 배치됩니다.

구문

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

매개 변수

[in] ec

ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져온 쿠키를 편집합니다.

[in] rguidService

포함된 콘텐츠를 가져오는 방법을 지정하는 식별자입니다.

값	의미
GUID_TS_SERVICE_ACCESSIBLE	출력은 Accessible 개체여야 합니다.
GUID_TS_SERVICE_ACTIVEX	호출자는 riid로 지정된 인터페이스를 지원하는 개체에 대한 직접 포인터가 필요합니다.
GUID_TS_SERVICE_DATAOBJECT	콘텐츠는 iDataObject 데이터 전송 개체로 가져와야 하며 riid 는 IID_IDataObject. 클라이언트는 콘텐츠 복사본이 필요한 경우 이 옵션을 지정해야 합니다.
호출자 정의	텍스트 서비스 및 컨텍스트 소유자는 사용자 지정 GUID를 정의할 수 있습니다.

[in] riid

요청된 개체의 인터페이스 UUID입니다.

[out] ppunk

개체에 대한 포인터입니다. riid와 일치하도록 캐스팅할 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_NOTIMPL	구현 애플리케이션은 텍스트 스트림에 포함된 개체를 노출하지 않습니다.
TF_E_NOINTERFACE	개체는 요청된 인터페이스를 지원하지 않습니다.
TF_E_NOLOCK	ec 매개 변수의 값이 잘못된 쿠키이거나 호출자에게 읽기 전용 잠금이 없습니다.
TF_E_NOOBJECT	범위의 시작 앵커는 TF_CHAR_EMBEDDED 문자 앞에 배치되지 않습니다.
TF_E_NOSERVICE	rguidService와 일치하도록 콘텐츠를 반환할 수 없습니다.

설명

가져온 개체는 특정 인터페이스를 지원하지 않을 수 있지만 개체는 포함된 문서 또는 IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache 또는 IDispatch와 같은 컨트롤과 연결된 인터페이스를 지원할 수 있습니다. 호출자는 QueryInterface 를 사용하여 흥미로운 인터페이스를 검색해야 합니다. 메서드가 성공하지만 riid 가 NULL인 경우 애플리케이션은 포함된 개체의 존재를 나타내지만 개체 자체를 노출하지는 않습니다. 텍스트 프로세서는 잠재적인 단어 분리에 대한 알림을 계속 활용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0