(msctf.h) ITfRange：：GetEmbedded 方法

發行項
02/29/2024

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 取得的 Cookie。

[in] rguidService

指定如何取得內嵌內容的識別碼。

值	意義
GUID_TS_SERVICE_ACCESSIBLE	輸出應該是可存取的物件。
GUID_TS_SERVICE_ACTIVEX	呼叫端需要物件的直接指標，該物件支援 riid 所指定的介面。
GUID_TS_SERVICE_DATAOBJECT	內容應取得為 IDataObject 數據傳輸物件，且 riid 正在IID_IDataObject。當需要內容複本時，客戶端應該指定此選項。
呼叫端定義	文字服務和內容擁有者可以定義自定義 GUID。

[in] riid

所要求對象的介面 UUID。

[out] ppunk

物件的指標。它可以轉換成符合 riid。

傳回值

這個方法可以傳回下列其中一個值。

值	描述
S_OK	此方法成功。
E_INVALIDARG	一或多個參數無效。
E_NOTIMPL	實作應用程式不會在其文字數據流中公開內嵌物件。
TF_E_NOINTERFACE	物件不支援要求的介面。
TF_E_NOLOCK	ec 參數中的值是無效的 Cookie，或呼叫端沒有唯讀鎖定。
TF_E_NOOBJECT	範圍的開始錨點不在TF_CHAR_EMBEDDED字元之前。
TF_E_NOSERVICE	無法傳回內容以符合 rguidService。

備註

雖然取得的物件可能不支援某些介面，但物件可能會支援與內嵌檔或控件相關聯的介面，例如 IOleObject、IDataObject、IViewObject、IPersistStorage、IOleCache 或 IDispatch。呼叫端必須使用 QueryInterface 來探查任何有趣的介面。如果方法成功但 riid 為 NULL，則應用程式會指出內嵌物件存在，但不會公開物件本身。文字處理器仍可受益於有關可能斷詞的通知。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0