Beskrivningshanterare

En deskriptor är en samling metadata som beskriver parametrarna för en SQL-instruktion eller kolumnerna i en resultatuppsättning, enligt programmet eller drivrutinen (kallas även implementeringen). Därför kan en beskrivning fylla någon av fyra roller:

• Application Parameter Descriptor (APD). Innehåller information om programbuffertar som är bundna till parametrarna i en SQL-instruktion, till exempel deras adresser, längder och C-datatyper.

• Implementeringsparameterbeskrivning (IPD). Innehåller information om parametrarna i en SQL-instruktion, till exempel deras SQL-datatyper, längder och nullbarhet.

• Application Row Descriptor (ARD). Innehåller information om programbuffertar som är bundna till kolumnerna i en resultatuppsättning, till exempel deras adresser, längder och C-datatyper.

• Implementeringsradbeskrivning (IRD). Innehåller information om kolumnerna i en resultatuppsättning, till exempel deras SQL-datatyper, längder och nullbarhet.

Fyra deskriptorer (en fyller varje roll) allokeras automatiskt när en instruktion allokeras. Dessa kallas automatiskt allokerade deskriptorer och är alltid associerade med den instruktionen. Program kan också allokera deskriptorer med SQLAllocHandle. Dessa kallas uttryckligen allokerade deskriptorer. De allokeras på en anslutning och kan associeras med ett eller flera uttryck på den anslutningen för att uppfylla rollen av en APD eller ARD till dessa uttryck.

De flesta åtgärder i ODBC kan utföras utan explicit användning av deskriptorer av programmet. Deskriptorer ger dock en praktisk genväg för vissa åtgärder. Anta till exempel att ett program vill infoga data från två olika uppsättningar buffertar. Om du vill använda den första uppsättningen buffertar anropar den upprepade gånger SQLBindParameter för att binda dem till parametrarna i en INSERT-instruktion och sedan köra -instruktionen. För att använda den andra uppsättningen buffertar skulle processen upprepas. Alternativt kan den konfigurera bindningar till den första uppsättningen buffertar i en deskriptor och till den andra uppsättningen buffertar i en annan deskriptor. För att växla mellan uppsättningarna med bindningar, anropar programmet helt enkelt SQLSetStmtAttr och associerar rätt deskriptor med uttalandet som APD.

Mer information om deskriptorer finns i Typer av deskriptorer.