SQLAsyncNotificationCallback İşlevi

Uygunluk
Kullanıma Sunulan Sürüm: ODBC 3.8

Standart Uyumluluğu: Yok

Özet
SQLAsyncNotificationCallback, sürücünün SQL_STILL_EXECUTING döndürmesinden sonra geçerli zaman uyumsuz işlem için bir ilerleme olduğunda Driver Manager'a geri çağrı yapmasına olanak tanır. SQLAsyncNotificationCallback yalnızca sürücü tarafından çağrılabilir.

Sürücüler SQLAsyncNotificationCallback işlevini SQLAsyncNotificationCallback işlev adıyla çağırmaz. Bunun yerine, Driver Manager bir işlev işaretçisini ilgili bağlantı tutamacının veya deyim tutamacının SQL_ATTR_ASYNC_DBC_NOTIFICATION_CALLBACK veya SQL_ATTR_ASYNC_STMT_NOTIFICATION_CALLBACK özniteliğinin değeri olarak sürücüye geçirir. Farklı tanıtıcılara farklı işlev işaretçisi değerleri atanabilir. İşlev işaretçisinin türü SQL_ASYNC_NOTIFICATION_CALLBACK olarak tanımlanır.

SQLAsyncNotificationCallback iş parçacığı açısından güvenlidir. Bir sürücü, aynı anda farklı tanıtıcılarda SQLAsyncNotificationCallback çağırmak için birden fazla iş parçacığı kullanmayı tercih edebilir.

Sözdizimi

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

Arguments

pContex
Sürücü Yöneticisi tarafından tanımlanan bir veri yapısının işaretçisi. Değer sürücüye SQLSetConnectAttr(SQL_ATTR_ASYNC_DBC_NOTIFICATION_CONTEXT) veya SQLSetStmtAttr(SQL_ATTR_ASYNC_STMT_NOTIFICATION_CONTEXT) aracılığıyla geçirilir. Sürücünün değere erişimi yok.

fLast
Geçerli asenkron işlem için son çağrının bu geri çağırma işlevi olduğunu belirten bir sürücü tarafından kullanılır. Sürücü Yöneticisi işlevi yeniden çağırdığında sürücü SQL_STILL_EXECUTING dışında bir dönüş kodu döndürür. Sürücü Yöneticisi bu bilgileri kullanabilir, örneğin, zaman uyumsuz işlemin tamamlanacağı konusunda uygulamayı önceden bilgilendirmek için.

Handle, HandleType tarafından belirtilen türün geçerli bir tanıtıcısı değilse, SQLCancelHandle SQL_INVALID_HANDLE döndürür.

İade

SQL_SUCCESS veya SQL_ERROR.

Diagnostics

SQLAsyncNotificationCallback , aşağıdaki iki durum için SQL_ERROR döndürebilir (bunlar sürücü veya Sürücü Yöneticisi'nde bir uygulama sorunu olduğunu gösterir.

Ayrıca Bkz.

Asenkron Yürütme (Polling Yöntemi)