Função LePinBlock Direto

Esta função é chamada diretamente pela aplicação da “Automação Comercial” para efetuar a coleta da senha do portador de um cartão proprietário (do próprio estabelecimento comercial).

int LePinblockDireto (int iModoCripto, char *lpcCartao, char *lpcTuiccs, int iTimeout, char *lpcParamAdic,
short (CALLBACK *pTstCancela) (void), char *lpcSaida, int iTamMsg, char *lpcMsg)
void LePinblockDiretoA (char *lpcResultado, char *lpcModoCripto, char *lpcCartao, char *lpcTuiccs,
char *lpcTimeout, char *lpcParamAdic, char *lpcSaida, char *lpcTamMsg, char *lpcMsg)

Parâmetro	Tipo	Interaface padrão	Interface ASCII	Descrição
lpcResultado	Saída	Não usado	Fixo 6 bytes	Contém o resultado de resposta à chamada da rotina
lpcCartao	Entrada	char *(finalizado com nulo)	Variável (deve ser passado entre delimitadores: `{}, [], (), ou <>)`	Identificação do cartão de 6 a 19 dígitos. Também é aceito a trilha 1, ou a trilha 2 do cartão.
lpcTuiccs	Entrada	char * (finalizado com nulo)	Variável (deve ser passado entre delimitadores: `{}, [], (), ou <>)`	Token único para identificação de cliente na coleta de senha. Este buffer, fornecido pela Software Express, deverá ser informado como parâmetro desta função pela “Automação Comercial”. Indica o modo escolhido para a coleta de senha: “OFF-Line” ou “ON-Line”. Para cada modo de coleta existe um TUICCS específico.
Timeout	Entrada	int	Fixo 3 bytes	Tempo de espera, em segundos, para digitação da senha. Se for passado o valor 0, será utilizado um valor default de 30 segundos.
lpcParamAdic	Entrada	char * (finalizado por nulo)	Variável (deve ser passado entre delimitadores : `{}, [], (), ou <>)` )	Tamanho mínimo e máximo da senha no formato: `{ColetaSenhaTamMin=4;ColetaSenhaTamMax=12}` Onde ColetaSenhaTamMin é o tamanho mínimo da senha e ColetaSenhaTamMax é o tamanho máximo. Caso seja passado nulo ou uma string vazia, os tamanhos assumirão os valores padrões de 4 para o tamanho mínimo e 12 para o máximo. Caso o tamanho mínimo seja menor que 4, o tamanho mínimo considerado será 4. Caso o tamanho máximo seja maior que 12, o tamanho máximo considerado será 12.
pTstCancela	Entrada	Func *	Não usado	Rotina Callback da aplicação da “Automação Comercial”. Permite ao “Operador” cancelar a digitação da senha. Se retornar: “0” - Indica para a CliSiTef que deseja continuar aguardando a digitação da senha. “1” - Indica que o “Operador” deseja cancelar a digitação da senha. Parâmetro opcional. A automação deverá passar NULL neste parâmetro, se não desejar que a coleta de senha seja cancelada pelo “Operador”.
lpcSaida	Saída	char * (finalizado com nulo)	Fixo 16 bytes	Retorna um pinblock da senha criptografada
lpcTamMsg	Entrada	Int	Fixo 6 bytes	Indica tamanho máximo do campo “lpcMsg” para retorno de mensagem no processo de coleta de senha. Valor mínimo é 2, mas recomenda-se valor de 128 bytes. Mensagens maiores que o tamanho informado serão truncadas.
lpcMsg	Saída	char * (finalizado com nulo)	Fixo ‘lpcTamMsg’ bytes	Retorna mensagem informativa sobre o processo de coleta de pinblock. O tamanho máximo da mensagem é o indicado em lpcTamMsg. Em caso de erro, trará uma mensagem com detalhamento do erro ocorrido. Em caso de sucesso, indicará o modo de captura do pinblock, que será informado no formato TLV: `0010011 – pinblock coletado com chave DES` `0010012 – pinblock coletado com chave 3DES`

Home