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

CoCreateActivity

関数
COM+のアクティビティオブジェクトを作成する。
DLLcomsvcs.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

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

HRESULT CoCreateActivity(
    IUnknown* pIUnknown,
    const GUID* riid,
    void** ppObj
);

パラメーター

名前方向
pIUnknownIUnknown*in
riidGUID*in
ppObjvoid**inout

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT CoCreateActivity(
    IUnknown* pIUnknown,
    const GUID* riid,
    void** ppObj
);
[DllImport("comsvcs.dll", ExactSpelling = true)]
static extern int CoCreateActivity(
    IntPtr pIUnknown,   // IUnknown*
    ref Guid riid,   // GUID*
    IntPtr ppObj   // void** in/out
);
<DllImport("comsvcs.dll", ExactSpelling:=True)>
Public Shared Function CoCreateActivity(
    pIUnknown As IntPtr,   ' IUnknown*
    ByRef riid As Guid,   ' GUID*
    ppObj As IntPtr   ' void** in/out
) As Integer
End Function
' pIUnknown : IUnknown*
' riid : GUID*
' ppObj : void** in/out
Declare PtrSafe Function CoCreateActivity Lib "comsvcs" ( _
    ByVal pIUnknown As LongPtr, _
    ByVal riid As LongPtr, _
    ByVal ppObj As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CoCreateActivity = ctypes.windll.comsvcs.CoCreateActivity
CoCreateActivity.restype = ctypes.c_int
CoCreateActivity.argtypes = [
    ctypes.c_void_p,  # pIUnknown : IUnknown*
    ctypes.c_void_p,  # riid : GUID*
    ctypes.c_void_p,  # ppObj : void** in/out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('comsvcs.dll')
CoCreateActivity = Fiddle::Function.new(
  lib['CoCreateActivity'],
  [
    Fiddle::TYPE_VOIDP,  # pIUnknown : IUnknown*
    Fiddle::TYPE_VOIDP,  # riid : GUID*
    Fiddle::TYPE_VOIDP,  # ppObj : void** in/out
  ],
  Fiddle::TYPE_INT)
#[link(name = "comsvcs")]
extern "system" {
    fn CoCreateActivity(
        pIUnknown: *mut core::ffi::c_void,  // IUnknown*
        riid: *const GUID,  // GUID*
        ppObj: *mut *mut ()  // void** in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("comsvcs.dll")]
public static extern int CoCreateActivity(IntPtr pIUnknown, ref Guid riid, IntPtr ppObj);
"@
$api = Add-Type -MemberDefinition $sig -Name 'comsvcs_CoCreateActivity' -Namespace Win32 -PassThru
# $api::CoCreateActivity(pIUnknown, riid, ppObj)
#uselib "comsvcs.dll"
#func global CoCreateActivity "CoCreateActivity" sptr, sptr, sptr
; CoCreateActivity pIUnknown, varptr(riid), ppObj   ; 戻り値は stat
; pIUnknown : IUnknown* -> "sptr"
; riid : GUID* -> "sptr"
; ppObj : void** in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "comsvcs.dll"
#cfunc global CoCreateActivity "CoCreateActivity" sptr, var, sptr
; res = CoCreateActivity(pIUnknown, riid, ppObj)
; pIUnknown : IUnknown* -> "sptr"
; riid : GUID* -> "var"
; ppObj : void** in/out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; HRESULT CoCreateActivity(IUnknown* pIUnknown, GUID* riid, void** ppObj)
#uselib "comsvcs.dll"
#cfunc global CoCreateActivity "CoCreateActivity" intptr, var, intptr
; res = CoCreateActivity(pIUnknown, riid, ppObj)
; pIUnknown : IUnknown* -> "intptr"
; riid : GUID* -> "var"
; ppObj : void** in/out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	comsvcs = windows.NewLazySystemDLL("comsvcs.dll")
	procCoCreateActivity = comsvcs.NewProc("CoCreateActivity")
)

// pIUnknown (IUnknown*), riid (GUID*), ppObj (void** in/out)
r1, _, err := procCoCreateActivity.Call(
	uintptr(pIUnknown),
	uintptr(riid),
	uintptr(ppObj),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function CoCreateActivity(
  pIUnknown: Pointer;   // IUnknown*
  riid: PGUID;   // GUID*
  ppObj: Pointer   // void** in/out
): Integer; stdcall;
  external 'comsvcs.dll' name 'CoCreateActivity';
result := DllCall("comsvcs\CoCreateActivity"
    , "Ptr", pIUnknown   ; IUnknown*
    , "Ptr", riid   ; GUID*
    , "Ptr", ppObj   ; void** in/out
    , "Int")   ; return: HRESULT
●CoCreateActivity(pIUnknown, riid, ppObj) = DLL("comsvcs.dll", "int CoCreateActivity(void*, void*, void*)")
# 呼び出し: CoCreateActivity(pIUnknown, riid, ppObj)
# pIUnknown : IUnknown* -> "void*"
# riid : GUID* -> "void*"
# ppObj : void** in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。