Win32 API 日本語リファレンス
ホームSystem.Wmi › MI_Application_InitializeV1

MI_Application_InitializeV1

関数
WMI/OMIのMIアプリケーションコンテキストを初期化する。
DLLmi.dll呼出規約cdecl対応OSwindows8.0

シグネチャ

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

MI_Result MI_Application_InitializeV1(
    DWORD flags,
    const WORD* applicationID,   // optional
    MI_Instance** extendedError,   // optional
    MI_Application* application
);

パラメーター

名前方向説明
flagsDWORDin初期化動作を制御するフラグ。通常は0を指定する。
applicationIDWORD*inoptionalアプリケーションを識別する文字列(WORD配列)へのポインタ。NULL可。
extendedErrorMI_Instance**outoptional出力としてエラー詳細を表すMI_Instanceを受け取るポインタのアドレス。NULL可。
applicationMI_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 方式にも切替可。
出力引数:
; 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 方式にも切替可。
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_Result
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';
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 を使用。

関連項目

使用する型