ITfKeystrokeMgr::GetPreservedKey-Methode (msctf.h)
Ruft die Befehls-GUID für einen beibehaltenen Schlüssel ab.
Syntax
HRESULT GetPreservedKey(
[in] ITfContext *pic,
[in] const TF_PRESERVEDKEY *pprekey,
[out] GUID *pguid
);
Parameter
[in] pic
Zeiger auf den Anwendungskontext. Dieser Wert wird von einem vorherigen Aufruf von ITfDocumentMgr::CreateContext zurückgegeben.
[in] pprekey
Zeiger auf eine TF_PRESERVEDKEY-Struktur , die den zu erhaltenden Schlüssel identifiziert. Das uVKey-Element enthält den virtuellen Schlüsselcode, und das uModifiers-Element identifiziert die Modifizierer des beibehaltenen Schlüssels. Das uVKey-Element muss kleiner als 256 sein.
[out] pguid
Zeiger auf einen GUID-Wert, der die Befehls-GUID des beibehaltenen Schlüssels empfängt. Dies ist die GUID, die im TSF-Textdienstaufruf an ITfKeystrokeMgr::P reserveKey übergeben wird. Dieser Wert empfängt GUID_NULL, wenn der beibehaltene Schlüssel nicht gefunden wird.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich, und der beibehaltene Schlüssel wurde gefunden. |
|
Die Methode war erfolgreich, aber der beibehaltene Schlüssel wurde nicht gefunden. pguid erhält GUID_NULL. |
|
Mindestens ein Parameter ist ungültig. |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Beibehaltene Tasten werden von TSF-Textdiensten registriert und verwendet, um Tastenkombinationen für allgemeine Befehle bereitzustellen, die vom TSF-Textdienst implementiert werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msctf.h |
| DLL | Msctf.dll |
| Verteilbare Komponente | TSF 1.0 unter Windows 2000 Professional |