Compartir a través de

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

  • Artículo

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