ITfDocumentMgr::CreateContext 메서드(msctf.h)

아티클
02/29/2024

컨텍스트 개체를 만듭니다.

구문

HRESULT CreateContext(
  [in]  TfClientId   tidOwner,
  [in]  DWORD        dwFlags,
  [in]  IUnknown     *punk,
  [out] ITfContext   **ppic,
  [out] TfEditCookie *pecTextStore
);

매개 변수

[in] tidOwner

클라이언트 식별자입니다. 애플리케이션의 경우 이 값은 ITfThreadMgr::Activate에 대한 이전 호출에서 제공됩니다. 텍스트 서비스의 경우 이 값은 텍스트 서비스 ITfTextInputProcessor::Activate 메서드에 제공됩니다.

[in] dwFlags

예약됨, 0이어야 합니다.

[in] punk

ITextStoreACP 또는 ITfContextOwnerCompositionSink 인터페이스를 지원하는 개체에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

[out] ppic

컨텍스트를 수신하는 ITfContext 포인터의 주소입니다.

[out] pecTextStore

새 컨텍스트에 대한 편집 쿠키를 수신하는 TfEditCookie 값에 대한 포인터입니다. 이 값은 다양한 메서드의 컨텍스트를 식별합니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
E_OUTOFMEMORY	메모리 할당 오류가 발생했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

펑크 매개 변수에 대한 모든 참조는 컨텍스트가 제거되거나 ITfDocumentMgr::P op 메서드를 사용하여 스택에서 컨텍스트가 제거될 때 해제됩니다.

요구 사항

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