/CLRSUPPORTLASTERROR (PInvoke 呼び出しの最終エラー コードの保持)

更新 : 2007 年 11 月

/CLRSUPPORTLASTERROR は既定で有効になっており、P/Invoke 機構を通じて呼び出された関数の最終エラー コードを保持します。P/Invoke は、/clr を指定してコンパイルしたコードから DLL 内のネイティブ関数を呼び出すことができる機能です。

/CLRSUPPORTLASTERROR{:NO | SYSTEMDLL}

解説

最終エラー コードを保持すると、パフォーマンスの低下につながります。パフォーマンスが最終エラー コードの保持による影響を受けないようにするには、/CLRSUPPORTLASTERROR:NO でリンクします。

/CLRSUPPORTLASTERROR:SYSTEMDLL でリンクすると、パフォーマンスの影響を最小にできますが、保持されるのはシステム DLL の関数の最終エラー コードだけになります。システム DLL は次のいずれかとして定義されています。

メモ :
最終エラーの保持は、同じモジュールにある、CLR コードによって処理されるアンマネージ関数ではサポートされていません。

• 詳細については、「/clr (共通言語ランタイムのコンパイル)」を参照してください。

Visual Studio 開発環境でこのリンカ オプションを設定するには

1. プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。詳細については、「Visual C++ プロジェクトのプロパティの設定」を参照してください。

2. [リンカ] フォルダをクリックします。

3. [コマンド ライン] プロパティ ページをクリックします。

4. [追加のオプション] ボックスにオプションを入力します。

このリンカをコードから設定するには

• AdditionalOptions を参照してください。

使用例

次の例は、最終エラーを変更するエクスポート関数を 1 つ持つネイティブ DLL を定義します。

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

次の例では、DLL を処理し、/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);
}

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

参照

参照

リンカ オプションの設定

リンカ オプション