Configurar valores de parâmetro

Para definir o valor de um parâmetro, o aplicativo simplesmente define o valor da variável vinculada ao parâmetro. Não é importante quando esse valor é definido, desde que seja definido antes da execução da instrução. O aplicativo pode definir o valor antes ou após vincular a variável e pode alterar o valor quantas vezes desejar. Quando a instrução é executada, o driver simplesmente recupera o valor atual da variável. Isso é particularmente útil quando uma instrução preparada é executada mais de uma vez; o aplicativo define novos valores para algumas das variáveis ou todas elas sempre que a instrução é executada. Para obter um exemplo disso, consulte Execução preparada, anteriormente nesta seção.

Se um buffer de comprimento/indicador foi vinculado na chamada a SQLBindParameter, ele deverá ser definido como um dos seguintes valores antes que a instrução seja executada:

• O comprimento em bytes dos dados na variável associada. O driver verificará esse comprimento somente se a variável for caractere ou binária (se ValueType for SQL_C_CHAR ou SQL_C_BINARY).

• SQL_NTS. Os dados são uma cadeia de caracteres terminada em nulo.

• SQL_NULL_DATA. O valor dos dados é NULL e o driver ignora o valor da variável associada.

• SQL_DATA_AT_EXEC ou o resultado da macro SQL_LEN_DATA_AT_EXEC. O valor do parâmetro deve ser enviado com SQLPutData. Para obter mais informações, consulte Enviar dados long, mais adiante nesta seção.

A tabela a seguir mostra os valores da variável associada e do buffer de comprimento/indicador que o aplicativo define para uma variedade de valores de parâmetros.

Parâmetro value	Parâmetro (SQL) tipo de dados	Variável (C) tipo de dados	Valor em bound variable	Valor em comprimento/indicador buffer[d]
"ABC"	SQL_CHAR	SQL_C_CHAR	ABC\0[a]	SQL_NTS ou 3
10	SQL_INTEGER	SQL_C_SLONG	10	--
10	SQL_INTEGER	SQL_C_CHAR	10\0[a]	SQL_NTS ou 2
13h	SQL_TYPE_TIME	SQL_C_TYPE_TIME	13,0,0[b]	--
13h	SQL_TYPE_TIME	SQL_C_CHAR	{t '13:00:00'}\0[a], [c]	SQL_NTS ou 14
NULO	SQL_SMALLINT	SQL_C_SSHORT	--	SQL_NULL_DATA

[a] "\0" representa um caractere de terminação nula. O caractere de terminação nula será necessário somente se o valor no buffer de comprimento/indicador for SQL_NTS.

[b] Os números nessa lista são os números armazenados nos campos da estrutura TIME_STRUCT.

[c] A cadeia de caracteres usa a cláusula de escape de data ODBC. Para obter mais informações, consulte Literais de Data, Hora e Carimbo de data/hora.

[d] Os drivers devem sempre verificar esse valor para confirmar se é um valor especial, como SQL_NULL_DATA.

O que um driver faz com um valor de parâmetro em tempo de execução depende do driver. Se necessário, o driver converte o valor do tipo de dados C e comprimento de byte da variável associada para o tipo de dados SQL, precisão e escala do parâmetro. Na maioria dos casos, o driver envia o valor para a fonte de dados. Em alguns casos, ele formata o valor como texto e o insere na instrução SQL antes de enviar a instrução à fonte de dados.