Función GetContextPropertyValue (recapis.h)

Devuelve un valor de propiedad especificado del contexto del reconocedor.

Sintaxis

HRESULT GetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        *pcbSize,
  BYTE         *pProperty
);

Parámetros

hrc

Identificador del contexto del reconocedor.

pGuid

Propiedad para recuperar. Especifique un identificador único global (GUID) de propiedad predefinida o un GUID definido por la aplicación. Para obtener una lista de propiedades predefinidas, consulte los GUID de propiedad de reconocimiento.

pcbSize

En la entrada, el tamaño, en bytes, puede ser el búfer pProperty . En la salida, el tamaño, en bytes, es el búfer pProperty .

pProperty

Búfer asignado por el usuario para contener el valor de propiedad. Para determinar el tamaño del búfer, establezca pProperty en NULL; use el tamaño para asignar pProperty.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
E_POINTER	Uno de los parámetros es un puntero no válido.
E_FAIL	Se ha producido un error no especificado.
E_INVALIDARG	Se recibió un argumento no válido.
TPC_E_UNINITIALIZED_PROPERTY	El contexto no ha establecido la propiedad . Esto puede ocurrir si la propiedad se establece solo en determinadas circunstancias, o si la propiedad se va a establecer solo después de un evento que aún no se ha producido.
TPC_E_INVALID_PROPERTY	El reconocedor no admite la propiedad .
TPC_E_INSUFFICIENT_BUFFER	El búfer pProperty es demasiado pequeño.

Comentarios

Esta función es opcional.

Puede usar la función GetContextPropertyValue para obtener información de que el reconocedor vuelve al autor de la llamada. Esto permite a un reconocedor personalizado tener modos y configuraciones, y devolver datos únicos para ese reconocedor.

En los reconocedores de Microsoft, llamar a la función GetContextPropertyValue con el parámetro pcbSize establecido en un valor mayor que necesario no da lugar a un valor devuelto incorrecto. En su lugar, el código cambia automáticamente el tamaño al valor necesario para el GUID actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	recapis.h
Archivo DLL	inkobjcore.dll

Consulte también

GetContextPropertyList (función)

Función SetContextPropertyValue