Metodo ITfContext::GetAppProperty (msctf.h)

Ottiene una proprietà dell'applicazione.

Sintassi

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

Parametri

[in] guidProp

Specifica l'identificatore della proprietà. Questo può essere un identificatore personalizzato o uno degli identificatori di proprietà predefiniti.

[out] ppProp

Puntatore a un puntatore dell'interfaccia ITfReadOnlyProperty che riceve l'oggetto proprietà.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il proprietario del contesto non supporta la proprietà.
TF_E_DISCONNECTED	Il contesto non è in uno stack di documenti.
E_INVALIDARG	Uno o più parametri non sono validi.
E_OUTOFMEMORY	Si è verificato un errore di allocazione della memoria.
E_NOTIMPL	Il proprietario del contesto non implementa questo metodo.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Le applicazioni possono definire proprietà univoce identificate da un GUID. Le proprietà vengono archiviate come dati VARIANT, quindi il chiamante deve riconoscere il formato e il significato delle proprietà univoche per poterle usare.

Le proprietà dell'applicazione differiscono dalle proprietà di testo ottenute da ITfContext::GetProperty, in quanto le proprietà dell'applicazione vengono gestite dal proprietario del contesto e non possono essere modificate da un servizio di testo. Le proprietà dell'applicazione possono essere modificate solo dal proprietario del contesto.

Requisiti

Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

Interfaccia ITfContext, ITfContext::GetProperty, interfacciaITfReadOnlyProperty, Proprietà predefinite