SQLAsyncNotificationCallback függvény

Megfelelőség
Bevezetett verzió: ODBC 3.8

Szabványmegfelelőség: Nincs

Összefoglalás
Az SQLAsyncNotificationCallback lehetővé teszi, hogy az illesztőprogram visszahívja az illesztőprogram-kezelőt, amikor az aktuális aszinkron művelet során valamilyen előrehaladás történik, miután az illesztőprogram visszatér az SQL_STILL_EXECUTING értékkel. Az SQLAsyncNotificationCallbacket csak az illesztőprogram hívhatja meg.

Az illesztőprogramok nem hívják meg az SQLAsyncNotificationCallback függvényt SQLAsyncNotificationCallback függvénynévvel. Ehelyett az Illesztőprogram-kezelő egy függvénymutatót ad át egy illesztőprogramnak a megfelelő kapcsolati leíró vagy utasítás leíró SQL_ATTR_ASYNC_DBC_NOTIFICATION_CALLBACK vagy SQL_ATTR_ASYNC_STMT_NOTIFICATION_CALLBACK attribútumának értékeként. Különböző fogópontokhoz különböző függvénymutató-értékek rendelhetők. A függvénymutató típusa SQL_ASYNC_NOTIFICATION_CALLBACK.

Az SQLAsyncNotificationCallback szálbiztos. Egy illesztőprogram választhatja, hogy több szálat használjon, amelyek egyszerre hívják meg az SQLAsyncNotificationCallback függvényt különböző leírókon.

Szemantika

typedef SQLRETURN (SQL_API *SQL_ASYNC_NOTIFICATION_CALLBACK)(  
   SQLPOINTER pContex,   
   BOOL fLast);  

Arguments

pContex
Mutasson a Driver Manager által meghatározott adatstruktúrára. Az érték az SQLSetConnectAttr(SQL_ATTR_ASYNC_DBC_NOTIFICATION_CONTEXT) vagy az SQLSetStmtAttr(SQL_ATTR_ASYNC_STMT_NOTIFICATION_CONTEXT) segítségével továbbítódik az illesztőprogramnak. Az illesztőprogram nem rendelkezik hozzáféréssel az értékhez.

fLast
Az illesztőprogram ezt a visszahívási függvény meghívást használja annak jelzésére, hogy ez az utolsó az aktuális aszinkron művelethez. Az illesztőprogram a SQL_STILL_EXECUTING eltérő visszatérési kódot ad vissza, amikor az Illesztőprogram-kezelő ismét meghívja a függvényt. Az Illesztőprogram-kezelő felhasználhatja ezeket az információkat, például arra, hogy előre tájékoztassa az alkalmazást az aszinkron művelet befejezéséről.

Ha a Handle nem érvényes HandleType által megadott típusú mutató, az SQLCancelHandle SQL_INVALID_HANDLE értéket ad vissza.

Visszatérítések

SQL_SUCCESS vagy SQL_ERROR.

Diagnostics

Az SQLAsyncNotificationCallback a következő két helyzetben tud SQL_ERROR visszaadni (ezek implementálási problémát jeleznek az illesztőprogramban vagy az Illesztőprogram-kezelőben).

Error	Description
A kapcsolat vagy utasítás nem kért értesítést.
Érvénytelen azonosító	Az illesztőprogram érvénytelen leírót adott meg, és az nem felelt meg a belső meghajtókezelő ellenőrzési tesztjeinek.

Lásd még:

Aszinkron végrehajtás (lekérdezési módszer)