Partilhar via


Registros de diagnóstico

Associados com cada ambiente, conexão, instrução ou identificadores de descritor estão os registros de diagnóstico. Esses registros contêm informações de diagnóstico sobre a última função chamada que usou um identificador específico. Os registros são substituídos somente quando outra função é chamada usando esse identificador. Não há limite para o número de registros de diagnóstico que podem ser armazenados de uma só vez.

Há dois tipos de registros de diagnóstico: cabeçalho e zero ou mais registros de status. O registro de cabeçalho é registro 0; os registros de status são registros 1 e posteriores. Os registros de diagnóstico são compostos por vários campos separados, que são diferentes para o registro de cabeçalho e os registros de status. Além disso, os componentes ODBC podem definir seus próprios campos de registro de diagnóstico.

Embora os registros diagnósticos possam ser pensados como estruturas, não há exigência de que sejam realmente estruturas; A forma como um driver armazena as informações de diagnóstico é específica do driver.

Os campos nos registros de diagnóstico são recuperados com SQLGetDiagField. Os campos SQLSTATE, número de erro nativo e mensagem de diagnóstico dos registros de status podem ser recuperados em uma única chamada com SQLGetDiagRec.

Esta seção contém os tópicos a seguir.