Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
van toepassing op:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Een applicatie kan opslag toewijzen voor resultaten vóór of na het uitvoeren van een SQL-instructie. Als een applicatie eerst de SQL-instructie voorbereidt of uitvoert, kan deze eerst naar de resultatenset informeren voordat ze opslag voor resultaten toewijst. Als bijvoorbeeld de resultaatset onbekend is, moet de applicatie het aantal kolommen ophalen voordat opslag voor deze kan worden toegewezen.
Om opslag aan een kolom data toe te wijzen, roept een applicatie SQLBindCol aan en geeft deze door:
Het datatype waarnaar de data moet worden omgezet.
Het adres van een outputbuffer voor de data.
De applicatie moet deze buffer toewijzen, en deze moet groot genoeg zijn om de data in het formaat waarin het wordt omgezet te bevatten.
De lengte van de outputbuffer.
Deze waarde wordt genegeerd als de teruggegeven gegevens een vaste breedte in C hebben, zoals een geheel getal, reële getal of datumstructuur.
Het adres van een opslagbuffer om het aantal bytes beschikbare data terug te geven.
Een applicatie kan ook kolommen van resultaatsets binden aan arrays van programmavariabelen om het ophalen van rijen in blokken te ondersteunen. Er zijn twee verschillende soorten arraybinding:
Kolomgebonden binding is voltooid wanneer elke kolom aan zijn eigen variabelenarray is gebonden.
Kolomgewijze binding wordt gespecificeerd door SQLSetStmtAttr aan te roepen met Attribuut ingesteld op SQL_ATTR_ROW_BIND_TYPE en ValuePtr op SQL_BIND_BY_COLUMN. Alle arrays moeten hetzelfde aantal elementen hebben.
Rijgewijze binding is voltooid wanneer alle parameters in de SQL-instructie als één eenheid zijn gebonden aan een array van structuren die de individuele variabelen voor de parameters bevatten.
Rijgewijze binding wordt gespecificeerd door SQLSetStmtAttr aan te roepen met Attribuut ingesteld op SQL_ATTR_ROW_BIND_TYPE en ValuePtr ingesteld op de grootte van de structuur die de variabelen bevat die de kolommen van de resultaatset ontvangen.
De applicatie stelt ook SQL_ATTR_ROW_ARRAY_SIZE in op het aantal elementen in de kolom- of rijarrays en stelt SQL_ATTR_ROW_STATUS_PTR en SQL_ATTR_ROWS_FETCHED_PTR.