/ CLRSUPPORTLASTERROR (preservar último código de erro para chamadas de PInvoke)

Artigo
08/04/2011

/CLRSUPPORTLASTERROR, que é ativado por padrão, preserva o último código de erro das funções chamadas por meio do mecanismo P/Invoke, o que permite que você chamar funções nativas DLLs do código compilado com /clr.

/CLRSUPPORTLASTERROR{:NO | SYSTEMDLL}

Comentários

Preservar o último código de erro implica uma diminuição no desempenho. Se não quiser pagar o impacto de desempenho de preservar o último código de erro, vincular com /CLRSUPPORTLASTERROR:NO.

Você pode minimizar o impacto no desempenho por meio da vinculação com /CLRSUPPORTLASTERROR:SYSTEMDLL, que preserva apenas o último código de erro para funções no sistema de DLLs. Uma DLL de sistema é definido como um dos seguintes:

PARA ACLUI.DLL	ACTIVEDS.DLL	ADPTIF.DLL	ADVAPI32.DLL
ASYCFILT.DLL	AUTHZ.DLL	AVICAP32.DLL	AVIFIL32.DLL
GABINETE.DLL	CLUSAPI.DLL	COMCTL32.DLL	COMDLG32.DLL
COMSVCS.DLL	CREDUI.DLL	CRYPT32.DLL	CRYPTNET.DLL
CRYPTUI.DLL	D3D8THK.DLL	DBGENG.DLL	DBGHELP.DLL
ARQUIVO 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	CONSULTA.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	TRÁFEGO.DLL	URL.DLL
URLMON.DLL	USER32.DLL	USERENV.DLL	USP10.DLL
UXTHEME.DLL	VDMDBG.DLL	VERSÃO.DLL	WINFAX.DLL
WINHTTP.DLL	WININET.DLL	WINMM.DLL	WINSCARD.DLL
WINTRUST.DLL	WLDAP32.DLL	WOW32.DLL	WS2_32. DLL
WSNMP32.DLL	ARQUIVO WSOCK32.DLL	WTSAPI32.DLL	XOLEHLP.DLL

Observação
Preservar o último erro não há suporte para funções não gerenciadas são consumidos pelo código do CLR, no mesmo módulo.

For more information, see /CLR (common Language Runtime Compilation).

Para definir esta opção de vinculador no ambiente de desenvolvimento Visual Studio

Abra o projeto Property Pages caixa de diálogo. Para obter detalhes, consulte Definindo propriedades de projeto Visual C++.
Clique o vinculador pasta.
Clique na a linha de comando página de propriedades.
Digite a opção para o Opções adicionais de caixa.

Para definir esta opção de vinculador programaticamente

See AdditionalOptions.

Exemplo

O exemplo a seguir define uma DLL nativa com uma função exportada que modifica o último erro.

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

O exemplo a seguir consome a DLL, que demonstram como usar /CLRSUPPORTLASTERROR.

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

Consulte também

Referência

Configurando opções de vinculador

Opções do Vinculador

Compartilhar via