SQLSetConnectAttrForDbcInfo Funktion

Överensstämmelse
Version introducerad: ODBC 3.81 Standardefterlevnad: ODBC

Summary
SQLSetConnectAttrForDbcInfo är samma som SQLSetConnectAttr, men den sätter attributet på anslutningsinformationstoken istället för på anslutningshandtaget.

Syntax

  
SQLRETURN  SQLSetConnectAttrForDbcInfo(  
                SQLHDBC_INFO_TOKEN    hDbcInfoToken,  
                SQLINTEGER            Attribute,  
                SQLPOINTER            ValuePtr,  
                SQLINTEGER            StringLength );

Arguments

hDbcInfoToken
[Input] Token-handtag.

Attribut
[Input] Attribut till mängden. Listan över giltiga attribut är drivrutinsspecifik och densamma som för SQLSetConnectAttr.

ValuePtr
[Input] Peka på värdet som ska kopplas till Attribute. Beroende på värdet av Attribute kommer ValuePtr att vara ett 32-bitars osignerat heltalsvärde eller peka på en null-terminerad teckensträng. Observera att om Attribut-argumentet är ett drivrutinsspecifikt värde kan värdet i ValuePtr vara ett signerat heltal.

StringLength
[Input] Om Attribute är ett ODBC-definierat attribut och ValuePtr pekar på en teckensträng eller en binär buffert, bör detta argument vara längden på *ValuePtr. För teckensträngsdata bör detta argument innehålla antalet byte i strängen.

Om Attribut är ett ODBC-definierat attribut och ValuePtr är ett heltal, ignoreras StringLength .

Om Attribut är ett drivrutinsdefinierat attribut anger applikationen attributets natur till Driver Manager genom att sätta argumentet StringLength . StringLength kan ha följande värden:

  • Om ValuePtr är en pekare till en teckensträng, så är StringLength längden på strängen eller SQL_NTS.

  • Om ValuePtr är en pekare till en binär buffert, placerar applikationen resultatet av makrot SQL_LEN_BINARY_ATTR(längd) i StringLength. Detta placerar ett negativt värde i StringLength.

  • Om ValuePtr är en pekare till ett annat värde än en teckensträng eller en binär sträng, så bör StringLength ha värdet SQL_IS_POINTER.

  • Om ValuePtr innehåller ett fast längdvärde, är StringLength antingen SQL_IS_INTEGER eller SQL_IS_UINTEGER, beroende på vad som är lämpligt.

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR eller SQL_INVALID_HANDLE.

Diagnostics

Samma som SQLSetConnectAttr, förutom att Driver Manager använder en HandleType av SQL_HANDLE_DBC_INFO_TOKEN och ett Handle av hDbcInfoToken.

Remarks

SQLSetConnectAttrForDbcInfo är samma som SQLSetConnectAttr, men den sätter attributet på anslutningsinformationstoken istället för på anslutningshandtaget. Till exempel, om SQLSetConnectAttr inte känner igen ett attribut, bör SQLSetConnectAttrForDbcInfo också returnera SQL_ERROR för det attributet.

När drivrutinen returnerar SQL_ERROR eller SQL_INVALID_HANDLE bör drivrutinen ignorera detta attribut för att beräkna pool-ID:t. Dessutom hämtar Driver Manager diagnostisk information från hDbcInfoToken och returnerar SQL_SUCCESS_WITH_INFO till applikationen i SQLConnect och SQLDriverConnect. Därför kan en applikation hämta detaljer om varför vissa attribut inte kan sättas.

Applikationer bör inte anropa denna funktion direkt. En ODBC-drivrutin som stödjer drivrutinsmedveten anslutningspooling måste implementera denna funktion.

Inkludera sqlspi.h för ODBC-drivrutinsutveckling.

Relaterat innehåll

  • Uppdaterades senast