Método ITfContext::GetAppProperty (msctf.h)

Obtiene una propiedad de aplicación.

Sintaxis

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

Parámetros

[in] guidProp

Especifica el identificador de propiedad. Puede ser un identificador personalizado o uno de los identificadores de propiedad predefinidos.

[out] ppProp

Puntero a un puntero de interfaz ITfReadOnlyProperty que recibe el objeto de propiedad.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
S_FALSE	El propietario del contexto no admite la propiedad .
TF_E_DISCONNECTED	El contexto no está en una pila de documentos.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_OUTOFMEMORY	Error de asignación de memoria.
E_NOTIMPL	El propietario del contexto no implementa este método.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Las aplicaciones pueden definir propiedades únicas identificadas por un GUID. Las propiedades se almacenan como datos VARIANT, por lo que el autor de la llamada debe reconocer el formato y el significado de las propiedades únicas para poder usarlos.

Las propiedades de la aplicación difieren de las propiedades de texto, obtenidas por ITfContext::GetProperty, en que el propietario del contexto mantiene las propiedades de la aplicación y no se puede modificar mediante un servicio de texto. El propietario del contexto solo puede modificar las propiedades de la aplicación.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional

Consulte también

Interfaz ITfContext, ITfContext::GetProperty, interfaz ITfReadOnlyProperty, Propiedades predefinidas