/CLRSUPPORTLASTERROR (Letzten Fehlercode für PInvoke-Aufrufe beibehalten)

Artikel
07/20/2011

In der Standardeinstellung ist /CLRSUPPORTLASTERROR aktiviert und behält den letzten Fehlercode für Funktionen bei, die durch den P/Invoke-Mechanismus aufgerufen wurden. Dadurch sind Sie in der Lage, in mit /clr kompiliertem Code systemeigene Funktionen in DLLs aufzurufen.

/CLRSUPPORTLASTERROR{:NO | SYSTEMDLL}

Hinweise

Wenn der letzte Fehlercode beibehalten wird, führt dies zu einer verringerten Leistung. Stellen Sie eine Verknüpfung mit /CLRSUPPORTLASTERROR:NO her, wenn Sie keine Verringerung der Leistung durch Beibehalten des letzten Fehlercodes in Kauf nehmen möchten.

Sie können die Leistungsminderung durch Verknüpfen mit /CLRSUPPORTLASTERROR:SYSTEMDLL minimieren. Auf diese Weise wird lediglich für Funktionen in System-DLLs der letzte Fehlercode beibehalten. Bei einer System-DLL handelt es sich um eine der folgenden DLLs:

ACLUI.DLL	ACTIVEDS.DLL	ADPTIF.DLL	ADVAPI32.DLL
ASYCFILT.DLL	AUTHZ.DLL	AVICAP32.DLL	AVIFIL32.DLL
CABINET.DLL	CLUSAPI.DLL	COMCTL32.DLL	COMDLG32.DLL
COMSVCS.DLL	CREDUI.DLL	CRYPT32.DLL	CRYPTNET.DLL
CRYPTUI.DLL	D3D8THK.DLL	DBGENG.DLL	DBGHELP.DLL
DCIMAN32.DLL	DNSAPI.DLL	DSPROP.DLL	DSUIEXT.DLL
GDI32.DLL	GLU32.DLL	HLINK.DLL	ICM32.DLL
IMAGEHLP.DLL	IMM32.DLL	IPHLPAPI.DLL	IPROP.DLL
KERNEL32.DLL	KSUSER.DLL	LOADPERF.DLL	LZ32.DLL
MAPI32.DLL	MGMTAPI.DLL	MOBSYNC.DLL	MPR.DLL
MPRAPI.DLL	MQRT.DLL	MSACM32.DLL	MSCMS.DLL
MSI.DLL	MSIMG32.DLL	MSRATING.DLL	MSTASK.DLL
MSVFW32.DLL	MSWSOCK.DLL	MTXEX.DLL	NDDEAPI.DLL
NETAPI32.DLL	NPPTOOLS.DLL	NTDSAPI.DLL	NTDSBCLI.DLL
NTMSAPI.DLL	ODBC32.DLL	ODBCBCP.DLL	OLE32.DLL
OLEACC.DLL	OLEAUT32.DLL	OLEDLG.DLL	OPENGL32.DLL
PDH.DLL	POWRPROF.DLL	QOSNAME.DLL	QUERY.DLL
RASAPI32.DLL	RASDLG.DLL	RASSAPI.DLL	RESUTILS.DLL
RICHED20.DLL	RPCNS4.DLL	RPCRT4.DLL	RTM.DLL
RTUTILS.DLL	SCARDDLG.DLL	SECUR32.DLL	SENSAPI.DLL
SETUPAPI.DLL	SFC.DLL	SHELL32.DLL	SHFOLDER.DLL
SHLWAPI.DLL	SISBKUP.DLL	SNMPAPI.DLL	SRCLIENT.DLL
STI.DLL	TAPI32.DLL	TRAFFIC.DLL	URL.DLL
URLMON.DLL	USER32.DLL	USERENV.DLL	USP10.DLL
UXTHEME.DLL	VDMDBG.DLL	VERSION.DLL	WINFAX.DLL
WINHTTP.DLL	WININET.DLL	WINMM.DLL	WINSCARD.DLL
WINTRUST.DLL	WLDAP32.DLL	WOW32.DLL	WS2_32.DLL
WSNMP32.DLL	WSOCK32.DLL	WTSAPI32.DLL	XOLEHLP.DLL

Tipp

Ein Beibehalten des letzten Fehlercodes wird nicht von nicht verwalteten Funktionen unterstützt, die in demselben Modul von CLR-Code verwendet werden.

Weitere Informationen finden Sie unter /clr (Common Language Runtime-Kompilierung).

So legen Sie diese Linkeroption in der Visual Studio-Entwicklungsumgebung fest

Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.
Klicken Sie auf den Ordner Linker.
Klicken Sie auf die Eigenschaftenseite für die Befehlszeile.
Geben Sie die Option im Feld Zusätzliche Optionen ein.

So legen Sie diese Linkeroption programmgesteuert fest

Siehe AdditionalOptions.

Beispiel

Im folgenden Beispiel wird eine systemeigene DLL mit einer exportierten Funktion definiert, durch die der letzte Fehler geändert wird.

// CLRSUPPORTLASTERROR_dll.cpp
// compile with: /LD
#include <windows.h>
#include <math.h>

#pragma unmanaged
__declspec(dllexport) double MySqrt(__int64 n) {
   SetLastError(DWORD(-1));
   return sqrt(double(n));
}

Das folgende Beispiel enthält diese DLL, und die Verwendung von /CLRSUPPORTLASTERROR wird dargestellt.

// CLRSUPPORTLASTERROR_client.cpp
// compile with: /clr CLRSUPPORTLASTERROR_dll.lib /link /clrsupportlasterror:systemdll
// processor: x86
#include <windows.h>
#include <wininet.h>
#include <stdio.h>
#include <math.h>

#pragma comment(lib, "wininet.lib")

double MySqrt(__int64 n);

#pragma managed
int main() {
   double   d = 0.0;
   __int64 n = 65;
   HANDLE  hGroup = NULL;
   GROUPID groupID;
   DWORD   dwSet = 127, dwGet = 37;

   SetLastError(dwSet);
   d = MySqrt(n);
   dwGet = GetLastError();

   if (dwGet == DWORD(-1))
      printf_s("GetLastError for application call succeeded (%d).\n",
             dwGet);
   else
      printf_s("GetLastError for application call failed (%d).\n",
             dwGet);

   hGroup = FindFirstUrlCacheGroup(0, CACHEGROUP_SEARCH_ALL,
                           0, 0, &groupID, 0);
   dwGet = GetLastError();
   if (dwGet == 183)
      printf_s("GetLastError for system call succeeded (%d).\n",
             dwGet);
   else
      printf_s("GetLastError for system call failed (%d).\n",
             dwGet);
}

Siehe auch

Referenz

Festlegen von Linkeroptionen

Linkeroptionen

Freigeben über