Metodo ITfKeystrokeMgr::GetPreservedKey (msctf.h)

Ottiene il GUID del comando per una chiave mantenuta.

Sintassi

HRESULT GetPreservedKey(
  [in]  ITfContext            *pic,
  [in]  const TF_PRESERVEDKEY *pprekey,
  [out] GUID                  *pguid
);

Parametri

[in] pic

Puntatore al contesto dell'applicazione. Questo valore viene restituito da una chiamata precedente a ITfDocumentMgr::CreateContext.

[in] pprekey

Puntatore a una struttura TF_PRESERVEDKEY che identifica la chiave mantenuta da ottenere. Il membro uVKey contiene il codice della chiave virtuale e il membro uModifiers identifica i modificatori della chiave mantenuta. Il membro uVKey deve essere minore di 256.

[out] pguid

Puntatore a un valore GUID che riceve il GUID del comando della chiave mantenuta. Si tratta del GUID passato nella chiamata al servizio di testo TSF a ITfKeystrokeMgr::P reserveKey. Questo valore riceve GUID_NULL se la chiave mantenuta non viene trovata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo ha avuto esito positivo e la chiave mantenuta è stata trovata.
S_FALSE	Il metodo ha avuto esito positivo, ma la chiave mantenuta non è stata trovata. pguid riceve GUID_NULL.
E_INVALIDARG	Uno o più parametri non sono validi.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Le chiavi conservate vengono registrate dai servizi di testo TSF e usate per fornire tasti di scelta rapida ai comandi comuni implementati dal servizio di testo TSF.

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

ITfDocumentMgr::CreateContext

ITfKeystrokeMgr

ITfKeystrokeMgr::P reserveKey

TF_PRESERVEDKEY