Méthode ITfKeystrokeMgr::GetPreservedKey (msctf.h)
Obtient le GUID de commande pour une clé conservée.
Syntaxe
HRESULT GetPreservedKey(
[in] ITfContext *pic,
[in] const TF_PRESERVEDKEY *pprekey,
[out] GUID *pguid
);
Paramètres
[in] pic
Pointeur vers le contexte de l’application. Cette valeur est retournée par un appel précédent à ITfDocumentMgr::CreateContext.
[in] pprekey
Pointeur vers une structure TF_PRESERVEDKEY qui identifie la clé conservée à obtenir. Le membre uVKey contient le code de clé virtuelle et le membre uModifiers identifie les modificateurs de la clé conservée. Le membre uVKey doit être inférieur à 256.
[out] pguid
Pointeur vers une valeur GUID qui reçoit le GUID de commande de la clé conservée. Il s’agit du GUID passé dans l’appel du service de texte TSF à ITfKeystrokeMgr::P reserveKey. Cette valeur reçoit GUID_NULL si la clé conservée est introuvable.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Description |
|---|---|
|
La méthode a réussi et la clé conservée a été trouvée. |
|
La méthode a réussi, mais la clé conservée n’a pas été trouvée. pguid reçoit GUID_NULL. |
|
Un ou plusieurs paramètres ne sont pas valides. |
|
Une erreur non spécifiée s'est produite. |
Notes
Les clés conservées sont inscrites par les services de texte TSF et utilisées pour fournir des raccourcis clavier aux commandes courantes implémentées par le service de texte TSF.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | msctf.h |
| DLL | Msctf.dll |
| Composant redistribuable | TSF 1.0 sur Windows 2000 Professionnel |