Funzione GetContextPropertyValue (recapis.h)

Articolo
03/01/2024

Restituisce un valore di proprietà specificato dal contesto di riconoscimento.

Sintassi

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

Parametri

hrc

Handle nel contesto del riconoscimento.

pGuid

Proprietà da recuperare. Specificare un identificatore univoco globale (GUID) o un GUID definito dall'applicazione. Per un elenco di proprietà predefinite, vedere i GUID delle proprietà di riconoscimento.

pcbSize

In input, le dimensioni, in byte, il buffer pProperty può essere. Nell'output, le dimensioni, in byte, il buffer pProperty è.

pProperty

Buffer allocato dall'utente per contenere il valore della proprietà. Per determinare le dimensioni del buffer, impostare pProperty su NULL; utilizzare le dimensioni per allocare pProperty.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Uno dei parametri è un puntatore non valido.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	È stato ricevuto un argomento non valido.
TPC_E_UNINITIALIZED_PROPERTY	La proprietà non è stata impostata dal contesto. Ciò può verificarsi se la proprietà è impostata solo in determinate circostanze o se la proprietà deve essere impostata solo dopo un evento che non è ancora stato eseguito.
TPC_E_INVALID_PROPERTY	Il riconoscimento non supporta la proprietà.
TPC_E_INSUFFICIENT_BUFFER	Il buffer pProperty è troppo piccolo.

Commenti

Questa funzione è facoltativa.

È possibile usare la funzione GetContextPropertyValue per ottenere informazioni che il riconoscimento restituisce al chiamante. Ciò consente a un riconoscimento personalizzato di avere modalità e impostazioni e di restituire i dati univoci per tale riconoscimento.

Nei riconoscitori Microsoft chiamare la funzione GetContextPropertyValue con il parametro pcbSize impostato su un valore maggiore di quello richiesto non genera un valore restituito non corretto. Il codice modifica automaticamente le dimensioni al valore richiesto per il GUID corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	recapis.h
DLL	inkobjcore.dll

Vedi anche

Funzione GetContextPropertyList

Funzione SetContextPropertyValue

Condividi tramite