Win32 API 日本語リファレンス
ホーム › Storage.Imapi › GetAttribIMsgOnIStg

GetAttribIMsgOnIStg

関数
IStorage上のIMessageのプロパティ属性を取得する。
DLLMAPI32.dll呼出規約winapi
📘 Microsoft Learn (日本語) · English

シグネチャ

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

HRESULT GetAttribIMsgOnIStg(
    void* lpObject,
    SPropTagArray* lpPropTagArray,
    SPropAttrArray** lppPropAttrArray
);

パラメーター

名前型方向説明
lpObjectvoid*inout属性を取得する対象のIMsgOnIStgオブジェクトへのポインタ。
lpPropTagArraySPropTagArray*inout属性を問い合わせるプロパティタグ配列SPropTagArrayへのポインタ。
lppPropAttrArraySPropAttrArray**inout各プロパティの属性を受け取るSPropAttrArrayへのポインタ。

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT GetAttribIMsgOnIStg(
    void* lpObject,
    SPropTagArray* lpPropTagArray,
    SPropAttrArray** lppPropAttrArray
);
[DllImport("MAPI32.dll", ExactSpelling = true)]
static extern int GetAttribIMsgOnIStg(
    IntPtr lpObject,   // void* in/out
    IntPtr lpPropTagArray,   // SPropTagArray* in/out
    IntPtr lppPropAttrArray   // SPropAttrArray** in/out
);
<DllImport("MAPI32.dll", ExactSpelling:=True)>
Public Shared Function GetAttribIMsgOnIStg(
    lpObject As IntPtr,   ' void* in/out
    lpPropTagArray As IntPtr,   ' SPropTagArray* in/out
    lppPropAttrArray As IntPtr   ' SPropAttrArray** in/out
) As Integer
End Function
' lpObject : void* in/out
' lpPropTagArray : SPropTagArray* in/out
' lppPropAttrArray : SPropAttrArray** in/out
Declare PtrSafe Function GetAttribIMsgOnIStg Lib "mapi32" ( _
    ByVal lpObject As LongPtr, _
    ByVal lpPropTagArray As LongPtr, _
    ByVal lppPropAttrArray As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

GetAttribIMsgOnIStg = ctypes.windll.mapi32.GetAttribIMsgOnIStg
GetAttribIMsgOnIStg.restype = ctypes.c_int
GetAttribIMsgOnIStg.argtypes = [
    ctypes.POINTER(None),  # lpObject : void* in/out
    ctypes.c_void_p,  # lpPropTagArray : SPropTagArray* in/out
    ctypes.c_void_p,  # lppPropAttrArray : SPropAttrArray** in/out
]
require 'fiddle'
require 'fiddle/import'

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

var (
	mapi32 = windows.NewLazySystemDLL("MAPI32.dll")
	procGetAttribIMsgOnIStg = mapi32.NewProc("GetAttribIMsgOnIStg")
)

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