Compartilhar via


Registros de diagnóstico

Associados a cada ambiente, conexão, instrução e identificador de descritor, estão os registros de diagnóstico. Esses registros contêm informações de diagnóstico sobre a última função que foi chamada usando 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 a qualquer momento.

Há dois tipos de registros de diagnóstico: um registro de cabeçalho e zero ou mais registros de status. O registro de cabeçalho é o registro 0; os registros de status são registros 1 e acima. 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 de diagnóstico possam ser considerados estruturas, não há nenhum requisito para que eles realmente sejam estruturas; como um driver armazena as informações de diagnóstico é específico 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 de registros de status podem ser recuperados em uma única chamada com SQLGetDiagRec.

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