Método ITfKeystrokeMgr::GetPreservedKey (msctf.h)

Obtém o GUID de comando para uma chave preservada.

Sintaxe

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

Parâmetros

[in] pic

Ponteiro para o contexto do aplicativo. Esse valor é retornado por uma chamada anterior para ITfDocumentMgr::CreateContext.

[in] pprekey

Ponteiro para uma estrutura TF_PRESERVEDKEY que identifica a chave preservada a ser obtida. O membro uVKey contém o código de chave virtual e o membro uModifiers identifica os modificadores da chave preservada. O membro uVKey deve ser menor que 256.

[out] pguid

Ponteiro para um valor GUID que recebe o GUID de comando da chave preservada. Esse é o GUID passado na chamada do serviço de texto TSF para ITfKeystrokeMgr::P reserveKey. Esse valor receberá GUID_NULL se a chave preservada não for encontrada.

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido e a chave preservada foi encontrada.
S_FALSE
O método foi bem-sucedido, mas a chave preservada não foi encontrada. O pguid recebe GUID_NULL.
E_INVALIDARG
Um ou mais parâmetros são inválidos.
E_FAIL
Ocorreu um erro não especificado.

Comentários

As teclas preservadas são registradas pelos serviços de texto TSF e usadas para fornecer atalhos de teclado para comandos comuns implementados pelo serviço de texto TSF.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfDocumentMgr::CreateContext

ITfKeystrokeMgr

ITfKeystrokeMgr::P reserveKey

TF_PRESERVEDKEY