ITfContext::GetAppProperty 메서드(msctf.h)
애플리케이션 속성을 가져옵니다.
구문
HRESULT GetAppProperty(
[in] REFGUID guidProp,
[out] ITfReadOnlyProperty **ppProp
);
매개 변수
[in] guidProp
속성 식별자를 지정합니다. 사용자 지정 식별자 또는 미리 정의된 속성 식별자 중 하나일 수 있습니다.
[out] ppProp
속성 개체를 수신하는 ITfReadOnlyProperty 인터페이스 포인터에 대한 포인터입니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
컨텍스트 소유자는 속성을 지원하지 않습니다. |
|
컨텍스트가 문서 스택에 없습니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
메모리 할당 오류가 발생했습니다. |
|
컨텍스트 소유자는 이 메서드를 구현하지 않습니다. |
|
지정되지 않은 오류가 발생했습니다. |
설명
애플리케이션은 GUID로 식별되는 고유 속성을 정의할 수 있습니다. 속성은 VARIANT 데이터로 저장되므로 호출자는 고유 속성의 형식과 의미를 인식하여 사용할 수 있어야 합니다.
애플리케이션 속성은 ITfContext::GetProperty에서 가져온 텍스트 속성과 다릅니다. 즉, 애플리케이션 속성은 컨텍스트 소유자가 유지 관리하며 텍스트 서비스에서 수정할 수 없습니다. 애플리케이션 속성은 컨텍스트 소유자만 수정할 수 있습니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |
참고 항목
ITfContext 인터페이스, ITfContext::GetProperty, ITfReadOnlyProperty 인터페이스, 미리 정의된 속성