Win32 API 日本語リファレンス
ホームDevices.DeviceAndDriverInstallation › CM_MapCrToWin32Err

CM_MapCrToWin32Err

関数
CONFIGRETコードをWin32エラーコードへ変換する。
DLLCFGMGR32.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

// CFGMGR32.dll
#include <windows.h>

DWORD CM_MapCrToWin32Err(
    CONFIGRET CmReturnCode,
    DWORD DefaultErr
);

パラメーター

名前方向
CmReturnCodeCONFIGRETin
DefaultErrDWORDin

戻り値の型: DWORD

各言語での呼び出し定義

// CFGMGR32.dll
#include <windows.h>

DWORD CM_MapCrToWin32Err(
    CONFIGRET CmReturnCode,
    DWORD DefaultErr
);
[DllImport("CFGMGR32.dll", ExactSpelling = true)]
static extern uint CM_MapCrToWin32Err(
    uint CmReturnCode,   // CONFIGRET
    uint DefaultErr   // DWORD
);
<DllImport("CFGMGR32.dll", ExactSpelling:=True)>
Public Shared Function CM_MapCrToWin32Err(
    CmReturnCode As UInteger,   ' CONFIGRET
    DefaultErr As UInteger   ' DWORD
) As UInteger
End Function
' CmReturnCode : CONFIGRET
' DefaultErr : DWORD
Declare PtrSafe Function CM_MapCrToWin32Err Lib "cfgmgr32" ( _
    ByVal CmReturnCode As Long, _
    ByVal DefaultErr As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CM_MapCrToWin32Err = ctypes.windll.cfgmgr32.CM_MapCrToWin32Err
CM_MapCrToWin32Err.restype = wintypes.DWORD
CM_MapCrToWin32Err.argtypes = [
    wintypes.DWORD,  # CmReturnCode : CONFIGRET
    wintypes.DWORD,  # DefaultErr : DWORD
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CFGMGR32.dll')
CM_MapCrToWin32Err = Fiddle::Function.new(
  lib['CM_MapCrToWin32Err'],
  [
    -Fiddle::TYPE_INT,  # CmReturnCode : CONFIGRET
    -Fiddle::TYPE_INT,  # DefaultErr : DWORD
  ],
  -Fiddle::TYPE_INT)
#[link(name = "cfgmgr32")]
extern "system" {
    fn CM_MapCrToWin32Err(
        CmReturnCode: u32,  // CONFIGRET
        DefaultErr: u32  // DWORD
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("CFGMGR32.dll")]
public static extern uint CM_MapCrToWin32Err(uint CmReturnCode, uint DefaultErr);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CFGMGR32_CM_MapCrToWin32Err' -Namespace Win32 -PassThru
# $api::CM_MapCrToWin32Err(CmReturnCode, DefaultErr)
#uselib "CFGMGR32.dll"
#func global CM_MapCrToWin32Err "CM_MapCrToWin32Err" sptr, sptr
; CM_MapCrToWin32Err CmReturnCode, DefaultErr   ; 戻り値は stat
; CmReturnCode : CONFIGRET -> "sptr"
; DefaultErr : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "CFGMGR32.dll"
#cfunc global CM_MapCrToWin32Err "CM_MapCrToWin32Err" int, int
; res = CM_MapCrToWin32Err(CmReturnCode, DefaultErr)
; CmReturnCode : CONFIGRET -> "int"
; DefaultErr : DWORD -> "int"
; DWORD CM_MapCrToWin32Err(CONFIGRET CmReturnCode, DWORD DefaultErr)
#uselib "CFGMGR32.dll"
#cfunc global CM_MapCrToWin32Err "CM_MapCrToWin32Err" int, int
; res = CM_MapCrToWin32Err(CmReturnCode, DefaultErr)
; CmReturnCode : CONFIGRET -> "int"
; DefaultErr : DWORD -> "int"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	cfgmgr32 = windows.NewLazySystemDLL("CFGMGR32.dll")
	procCM_MapCrToWin32Err = cfgmgr32.NewProc("CM_MapCrToWin32Err")
)

// CmReturnCode (CONFIGRET), DefaultErr (DWORD)
r1, _, err := procCM_MapCrToWin32Err.Call(
	uintptr(CmReturnCode),
	uintptr(DefaultErr),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function CM_MapCrToWin32Err(
  CmReturnCode: DWORD;   // CONFIGRET
  DefaultErr: DWORD   // DWORD
): DWORD; stdcall;
  external 'CFGMGR32.dll' name 'CM_MapCrToWin32Err';
result := DllCall("CFGMGR32\CM_MapCrToWin32Err"
    , "UInt", CmReturnCode   ; CONFIGRET
    , "UInt", DefaultErr   ; DWORD
    , "UInt")   ; return: DWORD
●CM_MapCrToWin32Err(CmReturnCode, DefaultErr) = DLL("CFGMGR32.dll", "dword CM_MapCrToWin32Err(dword, dword)")
# 呼び出し: CM_MapCrToWin32Err(CmReturnCode, DefaultErr)
# CmReturnCode : CONFIGRET -> "dword"
# DefaultErr : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。