Datenbankmakros und globale Variablen
Die unten aufgeführten Makros und Globalen gelten für ODBC-basierte Datenbankanwendungen. Sie werden nicht mit DAO-basierten Anwendungen verwendet.
Vor MFC 4.2 haben die Makros AFX_SQL_ASYNC und AFX_SQL_SYNC asynchrone Vorgänge die Möglichkeit gegeben, Zeit für andere Prozesse zu liefern. Ab MFC 4.2 wurde die Implementierung dieser Makros geändert, da die MFC ODBC-Klassen nur synchrone Vorgänge verwendet haben. Das Makro AFX_ODBC_CALL war neu bei MFC 4.2.
Datenbankmakros
| Name | Beschreibung |
|---|---|
| AFX_ODBC_CALL | Ruft eine ODBC-API-Funktion auf, die zurückgegeben wird SQL_STILL_EXECUTING. AFX_ODBC_CALL ruft die Funktion wiederholt auf, bis sie nicht mehr zurückgegeben wird SQL_STILL_EXECUTING. |
| AFX_SQL_ASYNC | Ruft AFX_ODBC_CALL. |
| AFX_SQL_SYNC | Ruft eine ODBC-API-Funktion auf, die nicht zurückgegeben wird SQL_STILL_EXECUTING. |
Datenbank-Globalen
| Name | Beschreibung |
|---|---|
| AfxDbInitModule | Fügt Datenbankunterstützung für eine normale MFC-DLL hinzu, die dynamisch mit MFC verknüpft ist. |
| AfxGetHENV | Ruft ein Handle für die ODBC-Umgebung ab, die derzeit von MFC verwendet wird. Sie können dieses Handle in direkten ODBC-Aufrufen verwenden. |
AfxDbInitModule
Fügen Sie für die Unterstützung der MFC-Datenbank (oder DAO) von einer regulären MFC-DLL, die dynamisch mit MFC verknüpft ist, einen Aufruf dieser Funktion in der Funktion der regulären MFC-DLL CWinApp::InitInstance hinzu, um die MFC-Datenbank-DLL zu initialisieren.
Syntax
void AFXAPI AfxDbInitModule( );
Hinweise
Stellen Sie sicher, dass dieser Aufruf vor einem Basisklassenaufruf oder einem hinzugefügten Code auftritt, der auf die MFC-Datenbank-DLL zugreift. Die MFC-Datenbank-DLL ist eine MFC-Erweiterungs-DLL; Damit eine MFC-Erweiterungs-DLL in eine CDynLinkLibrary Kette verkabelt werden kann, muss sie ein CDynLinkLibrary Objekt im Kontext jedes Moduls erstellen, das es verwendet. AfxDbInitModule erstellt das CDynLinkLibrary Objekt im Kontext Ihrer regulären MFC-DLL, sodass es in die CDynLinkLibrary Objektkette der regulären MFC-DLL verkabelt wird.
Anforderungen
Header:<afxdll_.h>
AFX_ODBC_CALL
Verwenden Sie dieses Makro, um eine beliebige ODBC-API-Funktion aufzurufen, die zurückgegeben SQL_STILL_EXECUTINGwerden kann.
AFX_ODBC_CALL(SQLFunc)
Parameter
SQLFunc
Eine ODBC-API-Funktion. Weitere Informationen zu ODBC-API-Funktionen finden Sie im Windows SDK.
Hinweise
AFX_ODBC_CALL ruft die Funktion wiederholt auf, bis sie nicht mehr zurückgegeben wird SQL_STILL_EXECUTING.
Vor dem Aufrufen AFX_ODBC_CALLmüssen Sie eine Variable nRetCodevom Typ RETCODE deklarieren.
Beachten Sie, dass die MFC ODBC-Klassen jetzt nur synchrone Verarbeitung verwenden. Um einen asynchronen Vorgang auszuführen, müssen Sie die ODBC-API-Funktion SQLSetConnectOptionaufrufen. Weitere Informationen finden Sie im Thema "Asynchrones Ausführen von Funktionen" im Windows SDK.
Beispiel
In diesem Beispiel wird AFX_ODBC_CALL die SQLColumns ODBC-API-Funktion aufgerufen, die eine Liste der Spalten in der tabelle mit dem Namen zurückgibt strTableName. Beachten Sie die Deklaration und nRetCode die Verwendung von Recordset-Datenmbern, um Parameter an die Funktion zu übergeben. Das Beispiel veranschaulicht auch die Überprüfung der Ergebnisse des Aufrufs mit Checkeiner Memberfunktion der Klasse CRecordset. Die Variable prs ist ein Zeiger auf ein CRecordset Objekt, das an anderer Stelle deklariert wird.
RETCODE nRetCode;
AFX_ODBC_CALL(::SQLColumns(prs->m_hstmt, (SQLTCHAR*)NULL, SQL_NTS, (SQLTCHAR*)NULL,
SQL_NTS, (SQLTCHAR*)strTableName.GetBuffer(), SQL_NTS, (SQLTCHAR*)NULL, SQL_NTS));
if (!prs->Check(nRetCode))
{
AfxThrowDBException(nRetCode, prs->m_pDatabase, prs->m_hstmt);
TRACE(_T("SQLColumns failed\n"));
}
Anforderungen
Header: afxdb.h
AFX_SQL_ASYNC
Die Implementierung dieses Makros wurde in MFC 4.2 geändert.
AFX_SQL_ASYNC(prs, SQLFunc)
Parameter
Prs
Ein Zeiger auf ein CRecordset Objekt oder ein CDatabase Objekt. Ab MFC 4.2 wird dieser Parameterwert ignoriert.
SQLFunc
Eine ODBC-API-Funktion. Weitere Informationen zu ODBC-API-Funktionen finden Sie im Windows SDK.
Hinweise
AFX_SQL_ASYNC ruft einfach das Makro AFX_ODBC_CALL auf und ignoriert den prs-Parameter . In MFC-Versionen vor 4.2 wurde verwendet, um ODBC-API-Funktionen aufzurufen, AFX_SQL_ASYNC die zurückgegeben SQL_STILL_EXECUTINGwerden können. Wenn eine ODBC-API-Funktion zurückgegeben SQL_STILL_EXECUTINGwurde, wird dies AFX_SQL_ASYNC aufgerufen prs->OnWaitForDataSource.
Hinweis
Die MFC ODBC-Klassen verwenden jetzt nur synchrone Verarbeitung. Um einen asynchronen Vorgang auszuführen, müssen Sie die ODBC-API-Funktion SQLSetConnectOptionaufrufen. Weitere Informationen finden Sie im Thema "Asynchrones Ausführen von Funktionen" im Windows SDK.
Anforderungen
Header afxdb.h
AFX_SQL_SYNC
Das AFX_SQL_SYNC Makro ruft einfach die Funktion SQLFuncauf.
AFX_SQL_SYNC(SQLFunc)
Parameter
SQLFunc
Eine ODBC-API-Funktion. Weitere Informationen zu diesen Funktionen finden Sie im Windows SDK.
Hinweise
Verwenden Sie dieses Makro, um ODBC-API-Funktionen aufzurufen, die nicht zurückgegeben SQL_STILL_EXECUTINGwerden.
Vor dem Aufrufen AFX_SQL_SYNCmüssen Sie eine Variable nRetCodevom Typ RETCODE deklarieren. Sie können den Wert nach nRetCode dem Makroaufruf überprüfen.
Beachten Sie, dass die Implementierung von AFX_SQL_SYNC geänderten Änderungen in MFC 4.2. Da die Überprüfung des Serverstatus nicht mehr erforderlich war, AFX_SQL_SYNC weist sie einfach einen Wert zu nRetCode. Statt z. B. den Anruf zu tätigen
AFX_SQL_SYNC(::SQLGetInfo(m_dbCust.m_hdbc, SQL_ODBC_SQL_CONFORMANCE,
&nValue, sizeof(nValue), &cbValue));
Sie können die Aufgabe einfach vornehmen.
nRetCode = ::SQLGetInfo(m_dbCust.m_hdbc, SQL_ODBC_SQL_CONFORMANCE,
&nValue, sizeof(nValue), &cbValue);
Anforderungen
Header afxdb.h
AfxGetHENV
Sie können das zurückgegebene Handle in direkten ODBC-Aufrufen verwenden, aber Sie dürfen das Handle nicht schließen oder davon ausgehen, dass das Handle noch gültig und verfügbar ist, nachdem vorhandene CDatabaseoder CRecordsetabgeleitete Objekte zerstört wurden.
HENV AFXAPI AfxGetHENV();
Rückgabewert
Das Handle für die ODBC-Umgebung, die derzeit von MFC verwendet wird. Kann seinSQL_HENV_NULL, wenn keine CDatabase-Objekte und keine CRecordset-Objekte verwendet werden.
Anforderungen
Header afxdb.h