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

Aktualisiert: November 2007

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

Hinweis:

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

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

  1. Öffnen Sie das Dialogfeld Eigenschaftenseiten des Projekts. Ausführliche Informationen finden Sie unter Festlegen von Visual C++-Projekteigenschaften.

  2. Klicken Sie auf den Ordner Linker.

  3. Klicken Sie auf die Eigenschaftenseite für die Befehlszeile.

  4. Geben Sie die Option im Feld Zusätzliche Optionen ein.

So legen Sie diese Linkeroption programmgesteuert fest

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);
}

GetLastError for application call failed (127).
GetLastError for system call succeeded (183).

Siehe auch

Referenz

Festlegen von Linkeroptionen

Linkeroptionen