ホーム › System.Wmi › MI_Application_InitializeV1
MI_Application_InitializeV1
関数WMI/OMIのMIアプリケーションコンテキストを初期化する。
シグネチャ
// mi.dll
#include <windows.h>
MI_Result MI_Application_InitializeV1(
DWORD flags,
const WORD* applicationID, // optional
MI_Instance** extendedError, // optional
MI_Application* application
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| flags | DWORD | in | 初期化動作を制御するフラグ。通常は0を指定する。 |
| applicationID | WORD* | inoptional | アプリケーションを識別する文字列(WORD配列)へのポインタ。NULL可。 |
| extendedError | MI_Instance** | outoptional | 出力としてエラー詳細を表すMI_Instanceを受け取るポインタのアドレス。NULL可。 |
| application | MI_Application* | out | 出力として初期化されたMI_Applicationハンドルを受け取る構造体ポインタ。 |
戻り値の型: MI_Result
各言語での呼び出し定義
// mi.dll
#include <windows.h>
MI_Result MI_Application_InitializeV1(
DWORD flags,
const WORD* applicationID, // optional
MI_Instance** extendedError, // optional
MI_Application* application
);[DllImport("mi.dll", ExactSpelling = true, CallingConvention = CallingConvention.Cdecl)]
static extern int MI_Application_InitializeV1(
uint flags, // DWORD
IntPtr applicationID, // WORD* optional
IntPtr extendedError, // MI_Instance** optional, out
IntPtr application // MI_Application* out
);<DllImport("mi.dll", ExactSpelling:=True, CallingConvention:=CallingConvention.Cdecl)>
Public Shared Function MI_Application_InitializeV1(
flags As UInteger, ' DWORD
applicationID As IntPtr, ' WORD* optional
extendedError As IntPtr, ' MI_Instance** optional, out
application As IntPtr ' MI_Application* out
) As Integer
End Function' flags : DWORD
' applicationID : WORD* optional
' extendedError : MI_Instance** optional, out
' application : MI_Application* out
Declare PtrSafe Function MI_Application_InitializeV1 Lib "mi" ( _
ByVal flags As Long, _
ByVal applicationID As LongPtr, _
ByVal extendedError As LongPtr, _
ByVal application As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
MI_Application_InitializeV1 = ctypes.cdll.mi.MI_Application_InitializeV1
MI_Application_InitializeV1.restype = ctypes.c_int
MI_Application_InitializeV1.argtypes = [
wintypes.DWORD, # flags : DWORD
ctypes.POINTER(ctypes.c_ushort), # applicationID : WORD* optional
ctypes.c_void_p, # extendedError : MI_Instance** optional, out
ctypes.c_void_p, # application : MI_Application* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('mi.dll')
MI_Application_InitializeV1 = Fiddle::Function.new(
lib['MI_Application_InitializeV1'],
[
-Fiddle::TYPE_INT, # flags : DWORD
Fiddle::TYPE_VOIDP, # applicationID : WORD* optional
Fiddle::TYPE_VOIDP, # extendedError : MI_Instance** optional, out
Fiddle::TYPE_VOIDP, # application : MI_Application* out
],
Fiddle::TYPE_INT, Fiddle::Function::CDECL)#[link(name = "mi")]
extern "C" {
fn MI_Application_InitializeV1(
flags: u32, // DWORD
applicationID: *const u16, // WORD* optional
extendedError: *mut *mut MI_Instance, // MI_Instance** optional, out
application: *mut MI_Application // MI_Application* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("mi.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int MI_Application_InitializeV1(uint flags, IntPtr applicationID, IntPtr extendedError, IntPtr application);
"@
$api = Add-Type -MemberDefinition $sig -Name 'mi_MI_Application_InitializeV1' -Namespace Win32 -PassThru
# $api::MI_Application_InitializeV1(flags, applicationID, extendedError, application)#uselib "mi.dll"
#func global MI_Application_InitializeV1 "MI_Application_InitializeV1" sptr, sptr, sptr, sptr
; MI_Application_InitializeV1 flags, varptr(applicationID), varptr(extendedError), varptr(application) ; 戻り値は stat
; flags : DWORD -> "sptr"
; applicationID : WORD* optional -> "sptr"
; extendedError : MI_Instance** optional, out -> "sptr"
; application : MI_Application* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "mi.dll" #cfunc global MI_Application_InitializeV1 "MI_Application_InitializeV1" int, var, var, var ; res = MI_Application_InitializeV1(flags, applicationID, extendedError, application) ; flags : DWORD -> "int" ; applicationID : WORD* optional -> "var" ; extendedError : MI_Instance** optional, out -> "var" ; application : MI_Application* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "mi.dll" #cfunc global MI_Application_InitializeV1 "MI_Application_InitializeV1" int, sptr, sptr, sptr ; res = MI_Application_InitializeV1(flags, varptr(applicationID), varptr(extendedError), varptr(application)) ; flags : DWORD -> "int" ; applicationID : WORD* optional -> "sptr" ; extendedError : MI_Instance** optional, out -> "sptr" ; application : MI_Application* out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; MI_Result MI_Application_InitializeV1(DWORD flags, WORD* applicationID, MI_Instance** extendedError, MI_Application* application) #uselib "mi.dll" #cfunc global MI_Application_InitializeV1 "MI_Application_InitializeV1" int, var, var, var ; res = MI_Application_InitializeV1(flags, applicationID, extendedError, application) ; flags : DWORD -> "int" ; applicationID : WORD* optional -> "var" ; extendedError : MI_Instance** optional, out -> "var" ; application : MI_Application* out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; MI_Result MI_Application_InitializeV1(DWORD flags, WORD* applicationID, MI_Instance** extendedError, MI_Application* application) #uselib "mi.dll" #cfunc global MI_Application_InitializeV1 "MI_Application_InitializeV1" int, intptr, intptr, intptr ; res = MI_Application_InitializeV1(flags, varptr(applicationID), varptr(extendedError), varptr(application)) ; flags : DWORD -> "int" ; applicationID : WORD* optional -> "intptr" ; extendedError : MI_Instance** optional, out -> "intptr" ; application : MI_Application* out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mi = windows.NewLazySystemDLL("mi.dll")
procMI_Application_InitializeV1 = mi.NewProc("MI_Application_InitializeV1")
)
// flags (DWORD), applicationID (WORD* optional), extendedError (MI_Instance** optional, out), application (MI_Application* out)
r1, _, err := procMI_Application_InitializeV1.Call(
uintptr(flags),
uintptr(applicationID),
uintptr(extendedError),
uintptr(application),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // MI_Resultfunction MI_Application_InitializeV1(
flags: DWORD; // DWORD
applicationID: Pointer; // WORD* optional
extendedError: Pointer; // MI_Instance** optional, out
application: Pointer // MI_Application* out
): Integer; cdecl;
external 'mi.dll' name 'MI_Application_InitializeV1';result := DllCall("mi\MI_Application_InitializeV1"
, "UInt", flags ; DWORD
, "Ptr", applicationID ; WORD* optional
, "Ptr", extendedError ; MI_Instance** optional, out
, "Ptr", application ; MI_Application* out
, "Cdecl Int") ; return: MI_Result●MI_Application_InitializeV1(flags, applicationID, extendedError, application) = DLL("mi.dll", "int MI_Application_InitializeV1(dword, void*, void*, void*)")
# 呼び出し: MI_Application_InitializeV1(flags, applicationID, extendedError, application)
# flags : DWORD -> "dword"
# applicationID : WORD* optional -> "void*"
# extendedError : MI_Instance** optional, out -> "void*"
# application : MI_Application* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※cdecl関数。DLL()宣言はstdcall前提。cdeclは EXEC_PTR(`cdecl`,…) を使用。const std = @import("std");
extern "mi" fn MI_Application_InitializeV1(
flags: u32, // DWORD
applicationID: [*c]u16, // WORD* optional
extendedError: [*c][*c]MI_Instance, // MI_Instance** optional, out
application: [*c]MI_Application // MI_Application* out
) callconv(.c) i32;proc MI_Application_InitializeV1(
flags: uint32, # DWORD
applicationID: ptr uint16, # WORD* optional
extendedError: ptr MI_Instance, # MI_Instance** optional, out
application: ptr MI_Application # MI_Application* out
): int32 {.importc: "MI_Application_InitializeV1", cdecl, dynlib: "mi.dll".}pragma(lib, "mi");
extern(C)
int MI_Application_InitializeV1(
uint flags, // DWORD
ushort* applicationID, // WORD* optional
MI_Instance** extendedError, // MI_Instance** optional, out
MI_Application* application // MI_Application* out
);ccall((:MI_Application_InitializeV1, "mi.dll"), Int32,
(UInt32, Ptr{UInt16}, Ptr{MI_Instance}, Ptr{MI_Application}),
flags, applicationID, extendedError, application)
# flags : DWORD -> UInt32
# applicationID : WORD* optional -> Ptr{UInt16}
# extendedError : MI_Instance** optional, out -> Ptr{MI_Instance}
# application : MI_Application* out -> Ptr{MI_Application}local ffi = require("ffi")
ffi.cdef[[
int32_t MI_Application_InitializeV1(
uint32_t flags,
uint16_t* applicationID,
void* extendedError,
void* application);
]]
local mi = ffi.load("mi")
-- mi.MI_Application_InitializeV1(flags, applicationID, extendedError, application)
-- flags : DWORD
-- applicationID : WORD* optional
-- extendedError : MI_Instance** optional, out
-- application : MI_Application* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('mi.dll');
const MI_Application_InitializeV1 = lib.func('__cdecl', 'MI_Application_InitializeV1', 'int32_t', ['uint32_t', 'uint16_t *', 'void *', 'void *']);
// MI_Application_InitializeV1(flags, applicationID, extendedError, application)
// flags : DWORD -> 'uint32_t'
// applicationID : WORD* optional -> 'uint16_t *'
// extendedError : MI_Instance** optional, out -> 'void *'
// application : MI_Application* out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("mi.dll", {
MI_Application_InitializeV1: { parameters: ["u32", "pointer", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.MI_Application_InitializeV1(flags, applicationID, extendedError, application)
// flags : DWORD -> "u32"
// applicationID : WORD* optional -> "pointer"
// extendedError : MI_Instance** optional, out -> "pointer"
// application : MI_Application* out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t MI_Application_InitializeV1(
uint32_t flags,
uint16_t* applicationID,
void* extendedError,
void* application);
C, "mi.dll");
// $ffi->MI_Application_InitializeV1(flags, applicationID, extendedError, application);
// flags : DWORD
// applicationID : WORD* optional
// extendedError : MI_Instance** optional, out
// application : MI_Application* out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Mi extends Library {
Mi INSTANCE = Native.load("mi", Mi.class);
int MI_Application_InitializeV1(
int flags, // DWORD
ShortByReference applicationID, // WORD* optional
Pointer extendedError, // MI_Instance** optional, out
Pointer application // MI_Application* out
);
}@[Link("mi")]
lib Libmi
fun MI_Application_InitializeV1 = MI_Application_InitializeV1(
flags : UInt32, # DWORD
applicationID : UInt16*, # WORD* optional
extendedError : MI_Instance**, # MI_Instance** optional, out
application : MI_Application* # MI_Application* out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef MI_Application_InitializeV1Native = Int32 Function(Uint32, Pointer<Uint16>, Pointer<Void>, Pointer<Void>);
typedef MI_Application_InitializeV1Dart = int Function(int, Pointer<Uint16>, Pointer<Void>, Pointer<Void>);
final MI_Application_InitializeV1 = DynamicLibrary.open('mi.dll')
.lookupFunction<MI_Application_InitializeV1Native, MI_Application_InitializeV1Dart>('MI_Application_InitializeV1');
// flags : DWORD -> Uint32
// applicationID : WORD* optional -> Pointer<Uint16>
// extendedError : MI_Instance** optional, out -> Pointer<Void>
// application : MI_Application* out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function MI_Application_InitializeV1(
flags: DWORD; // DWORD
applicationID: Pointer; // WORD* optional
extendedError: Pointer; // MI_Instance** optional, out
application: Pointer // MI_Application* out
): Integer; cdecl;
external 'mi.dll' name 'MI_Application_InitializeV1';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import ccall safe "MI_Application_InitializeV1"
c_MI_Application_InitializeV1 :: Word32 -> Ptr Word16 -> Ptr () -> Ptr () -> IO Int32
-- flags : DWORD -> Word32
-- applicationID : WORD* optional -> Ptr Word16
-- extendedError : MI_Instance** optional, out -> Ptr ()
-- application : MI_Application* out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let mi_application_initializev1 =
foreign "MI_Application_InitializeV1"
(uint32_t @-> (ptr uint16_t) @-> (ptr void) @-> (ptr void) @-> returning int32_t)
(* flags : DWORD -> uint32_t *)
(* applicationID : WORD* optional -> (ptr uint16_t) *)
(* extendedError : MI_Instance** optional, out -> (ptr void) *)
(* application : MI_Application* out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library mi (t "mi.dll"))
(cffi:use-foreign-library mi)
(cffi:defcfun ("MI_Application_InitializeV1" mi-application-initialize-v1 :convention :cdecl) :int32
(flags :uint32) ; DWORD
(application-id :pointer) ; WORD* optional
(extended-error :pointer) ; MI_Instance** optional, out
(application :pointer)) ; MI_Application* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $MI_Application_InitializeV1 = Win32::API::More->new('mi',
'int MI_Application_InitializeV1(DWORD flags, LPVOID applicationID, LPVOID extendedError, LPVOID application)');
# my $ret = $MI_Application_InitializeV1->Call($flags, $applicationID, $extendedError, $application);
# flags : DWORD -> DWORD
# applicationID : WORD* optional -> LPVOID
# extendedError : MI_Instance** optional, out -> LPVOID
# application : MI_Application* out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。