iTfContext：：GetAppProperty 方法 (msctf.h)

  • 项目

获取应用程序属性。

语法

HRESULT GetAppProperty(
  [in]  REFGUID             guidProp,
  [out] ITfReadOnlyProperty **ppProp
);

parameters

[in] guidProp

指定属性标识符。 这可以是自定义标识符或 预定义的属性标识符之一。

[out] ppProp

指向接收属性对象的 ITfReadOnlyProperty 接口指针的指针。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
S_FALSE
 上下文所有者不支持 属性。
TF_E_DISCONNECTED
 上下文不在文档堆栈上。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 发生内存分配失败。
E_NOTIMPL
 上下文所有者不实现此方法。
E_FAIL
 发生了未指定的错误。

注解

应用程序可以定义由 GUID 标识的唯一属性。 属性存储为 VARIANT 数据，因此调用方必须识别唯一属性的格式和含义才能使用它们。

应用程序属性与 ITfContext：：GetProperty 获取的文本属性不同，应用程序属性由上下文所有者维护，不能由文本服务修改。 应用程序属性只能由上下文所有者修改。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfContext 接口、 ITfContext：：GetProperty、 ITfReadOnlyProperty 接口、 预定义属性