Campos adiados

Os valores dos campos diferidos não são usados quando são definidos, mas o driver guarda os endereços das variáveis para um efeito diferido. Para um descritor de parâmetro de aplicação, o driver utiliza o conteúdo das variáveis no momento da chamada para SQLExecDirect ou SQLExecute. Para um descritor de linhas de aplicação, o driver utiliza o conteúdo das variáveis no momento da busca.

Os seguintes são campos diferidos:

• Os campos SQL_DESC_DATA_PTR e SQL_DESC_INDICATOR_PTR de um registo descritor.

• O campo SQL_DESC_OCTET_LENGTH_PTR de um registo descritor de aplicação.

• No caso de uma busca multilinha, os campos SQL_DESC_ARRAY_STATUS_PTR e SQL_DESC_ROWS_PROCESSED_PTR de um cabeçalho de descritor.

Quando um descritor é atribuído, os campos diferidos de cada registo descritor têm inicialmente um valor nulo. O significado do valor nulo é o seguinte:

• Se SQL_DESC_ARRAY_STATUS_PTR tiver um valor nulo, uma busca multilinha falha em devolver este componente da informação de diagnóstico por linha.

• Se SQL_DESC_DATA_PTR tiver um valor nulo, o registo é desvinculado.

• Se o campo SQL_DESC_OCTET_LENGTH_PTR de um ARD tiver um valor nulo, o driver não retorna informação de comprimento para essa coluna.

• Se o campo SQL_DESC_OCTET_LENGTH_PTR de um APD tiver um valor nulo e o parâmetro for uma cadeia de caracteres, o driver assume que essa cadeia é terminada em nulo. Para parâmetros dinâmicos de saída, um valor nulo neste campo impede o driver de devolver informação de comprimento. (Se o campo SQL_DESC_TYPE não indicar um parâmetro de cadeia de caracteres, o campo SQL_DESC_OCTET_LENGTH_PTR é ignorado.)

A aplicação não deve desalocar ou descartar variáveis usadas para campos diferidos entre o momento em que os associa aos campos e o momento em que o driver os lê ou escreve.