Partilhar via


Transições de descritor

Os descritores ODBC têm os três estados a seguir.

Estado Descrição
D0 Descritor não alocado
D1i Descritor alocado implicitamente
D1e Descritor alocado explicitamente

As tabelas a seguir mostram como cada função ODBC afeta o estado do descritor.

SQLAllocHandle

D0

Não alocado
D1i

Implícita
D1e

Explícita
D1i[1] -- --
D1e[2] -- --

[1] Esta linha mostra transições quando HandleType foi SQL_HANDLE_STMT.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DESC.

SQLCopyDesc

D0

Não alocado
D1i

Implícita
D1e

Explícita
(IH) -- --

SQLFreeHandle

D0

Não alocado
D1i

Implícita
D1e

Explícita
--[1] D0 --
(IH) [2] (HY017) D0

[1] Esta linha mostra transições quando HandleType foi SQL_HANDLE_STMT.

[2] Esta linha mostra transições quando HandleType foi SQL_HANDLE_DESC.

SQLGetDescField e SQLGetDescRec

D0

Não alocado
D1i

Implícita
D1e

Explícita
(IH) -- --

SQLSetDescField e SQLSetDescRec

D0

Não alocado
D1i

Implícita
D1e

Explícita
(IH) [1] -- --

[1] Esta linha mostra transições quando DescriptorHandle era o identificador de um ARD, APD ou IPD ou (para SQLSetDescField) quando DescriptorHandle era o identificador de um IRD e FieldIdentifier era SQL_DESC_ARRAY_STATUS_PTR ou SQL_DESC_ROWS_PROCESSED_PTR.

Todas as outras funções ODBC

D0

Não alocado
D1i

Implícita
D1e

Explícita
-- -- --