Instellen van descriptorvelden

Als u de velden van een descriptor wilt wijzigen, kan een toepassing SQLSetDescField aanroepen. Sommige velden hebben het kenmerk Alleen-lezen en kunnen niet worden ingesteld. (Zie de beschrijving van de functie SQLSetDescField .)

Descriptorrecordvelden worden ingesteld met een recordnummer (RecNumber) van 1 of hoger, terwijl descriptorheadervelden worden ingesteld met een recordnummer van 0. Een recordnummer van 0 wordt ook gebruikt om bladwijzer velden in te stellen, overeenkomstig de conventie dat bladwijzers zich bevinden in kolom 0. Dit kan de indruk achterlaten dat bladwijzervelden zich in de beschrijvingskop bevinden, maar dit is niet het geval. Bladwijzervelden verschillen van koptekstvelden.

Wanneer u velden afzonderlijk instelt, moet de toepassing de volgorde volgen die is gedefinieerd in SQLSetDescField. Als bepaalde velden worden ingesteld, stelt het stuurprogramma andere velden in. Dit zorgt ervoor dat de descriptor altijd gereed is voor gebruik zodra de toepassing een gegevenstype heeft opgegeven. Wanneer de toepassing het veld SQL_DESC_TYPE instelt, controleert het stuurprogramma of andere velden die het type opgeven geldig en consistent zijn.

Als een functieaanroep die een descriptorveld zou instellen mislukt, is de inhoud van het descriptorveld niet gedefinieerd na de mislukte functieaanroep.