Este comando é utilizado para aguardar o pressionamento de uma tecla no pin pad, retornando seu código. Por questão de segurança, este comando não retorna teclas numéricas, sendo que o pressionamento destas teclas é simplesmente ignorado pelo pin pad durante a execução do comando.

Este comando existe na PPCONECTA para uso livre do desenvolvedor da Aplicação de Pagamento, sendo seu uso opcional no fluxo do Cielo Conecta.

📘
Este comando é blocante, portanto deve ser usado com as funções PPC_StartExecCmd e PPC_FinishExecCmd.

Parâmetros de entrada

Não há.

Dados de resposta

Não há.

Retornos

Retorno	Descrição
PPC_OK	A tecla `[ENTRA/OK]` foi pressionada.
PPC_CANCEL	A tecla `[CANCELA]` foi pressionada.
PPC_BACKSP	A tecla `[LIMPA]` foi pressionada.
PPC_F1 a PPC_F4	Foi pressionada uma tecla de função (`[F1]` a `[F4]`).
PPC_NOTOPEN	O comando `PPC_CMD_OPEN` não foi chamado previamente.

Exemplo

int iAguardaTecla (void) 
{ 
   int iSt; 
   char sMsgNotify[32]; 

   iSt = PPC_StartExecCmd (PPC_CMD_GETKEY); 
   if (iSt != PPC_OK) return iSt; 

   do { 
      iSt = PPC_FinishExecCmd (sNotifyMsg); 
      if (iSt == PPC_NOTIFY) 
         ShowNotifyMessage (sNotifyMsg); 
      if (WishToAbort () == TRUE) { 
         PPC_AbortCmd (); 
         return -1; 
      } 
   } while (iSt == PPC_PROCESSING || iSt == PPC_NOTIFY); 
   return iSt; // Valor da tecla já retorna por aqui 
}