ホーム › System.Com.StructuredStorage › StgOpenStorageEx
StgOpenStorageEx
関数指定形式と属性で既存のストレージオブジェクトを開く。
シグネチャ
// OLE32.dll
#include <windows.h>
HRESULT StgOpenStorageEx(
LPCWSTR pwcsName,
STGM grfMode,
STGFMT stgfmt,
DWORD grfAttrs,
STGOPTIONS* pStgOptions, // optional
PSECURITY_DESCRIPTOR pSecurityDescriptor, // optional
const GUID* riid,
void** ppObjectOpen
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| pwcsName | LPCWSTR | in |
| grfMode | STGM | in |
| stgfmt | STGFMT | in |
| grfAttrs | DWORD | in |
| pStgOptions | STGOPTIONS* | inoutoptional |
| pSecurityDescriptor | PSECURITY_DESCRIPTOR | inoptional |
| riid | GUID* | in |
| ppObjectOpen | void** | out |
戻り値の型: HRESULT
各言語での呼び出し定義
// OLE32.dll
#include <windows.h>
HRESULT StgOpenStorageEx(
LPCWSTR pwcsName,
STGM grfMode,
STGFMT stgfmt,
DWORD grfAttrs,
STGOPTIONS* pStgOptions, // optional
PSECURITY_DESCRIPTOR pSecurityDescriptor, // optional
const GUID* riid,
void** ppObjectOpen
);[DllImport("OLE32.dll", ExactSpelling = true)]
static extern int StgOpenStorageEx(
[MarshalAs(UnmanagedType.LPWStr)] string pwcsName, // LPCWSTR
uint grfMode, // STGM
uint stgfmt, // STGFMT
uint grfAttrs, // DWORD
IntPtr pStgOptions, // STGOPTIONS* optional, in/out
IntPtr pSecurityDescriptor, // PSECURITY_DESCRIPTOR optional
ref Guid riid, // GUID*
IntPtr ppObjectOpen // void** out
);<DllImport("OLE32.dll", ExactSpelling:=True)>
Public Shared Function StgOpenStorageEx(
<MarshalAs(UnmanagedType.LPWStr)> pwcsName As String, ' LPCWSTR
grfMode As UInteger, ' STGM
stgfmt As UInteger, ' STGFMT
grfAttrs As UInteger, ' DWORD
pStgOptions As IntPtr, ' STGOPTIONS* optional, in/out
pSecurityDescriptor As IntPtr, ' PSECURITY_DESCRIPTOR optional
ByRef riid As Guid, ' GUID*
ppObjectOpen As IntPtr ' void** out
) As Integer
End Function' pwcsName : LPCWSTR
' grfMode : STGM
' stgfmt : STGFMT
' grfAttrs : DWORD
' pStgOptions : STGOPTIONS* optional, in/out
' pSecurityDescriptor : PSECURITY_DESCRIPTOR optional
' riid : GUID*
' ppObjectOpen : void** out
Declare PtrSafe Function StgOpenStorageEx Lib "ole32" ( _
ByVal pwcsName As LongPtr, _
ByVal grfMode As Long, _
ByVal stgfmt As Long, _
ByVal grfAttrs As Long, _
ByVal pStgOptions As LongPtr, _
ByVal pSecurityDescriptor As LongPtr, _
ByVal riid As LongPtr, _
ByVal ppObjectOpen As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
StgOpenStorageEx = ctypes.windll.ole32.StgOpenStorageEx
StgOpenStorageEx.restype = ctypes.c_int
StgOpenStorageEx.argtypes = [
wintypes.LPCWSTR, # pwcsName : LPCWSTR
wintypes.DWORD, # grfMode : STGM
wintypes.DWORD, # stgfmt : STGFMT
wintypes.DWORD, # grfAttrs : DWORD
ctypes.c_void_p, # pStgOptions : STGOPTIONS* optional, in/out
wintypes.HANDLE, # pSecurityDescriptor : PSECURITY_DESCRIPTOR optional
ctypes.c_void_p, # riid : GUID*
ctypes.c_void_p, # ppObjectOpen : void** out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('OLE32.dll')
StgOpenStorageEx = Fiddle::Function.new(
lib['StgOpenStorageEx'],
[
Fiddle::TYPE_VOIDP, # pwcsName : LPCWSTR
-Fiddle::TYPE_INT, # grfMode : STGM
-Fiddle::TYPE_INT, # stgfmt : STGFMT
-Fiddle::TYPE_INT, # grfAttrs : DWORD
Fiddle::TYPE_VOIDP, # pStgOptions : STGOPTIONS* optional, in/out
Fiddle::TYPE_VOIDP, # pSecurityDescriptor : PSECURITY_DESCRIPTOR optional
Fiddle::TYPE_VOIDP, # riid : GUID*
Fiddle::TYPE_VOIDP, # ppObjectOpen : void** out
],
Fiddle::TYPE_INT)#[link(name = "ole32")]
extern "system" {
fn StgOpenStorageEx(
pwcsName: *const u16, // LPCWSTR
grfMode: u32, // STGM
stgfmt: u32, // STGFMT
grfAttrs: u32, // DWORD
pStgOptions: *mut STGOPTIONS, // STGOPTIONS* optional, in/out
pSecurityDescriptor: *mut core::ffi::c_void, // PSECURITY_DESCRIPTOR optional
riid: *const GUID, // GUID*
ppObjectOpen: *mut *mut () // void** out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("OLE32.dll")]
public static extern int StgOpenStorageEx([MarshalAs(UnmanagedType.LPWStr)] string pwcsName, uint grfMode, uint stgfmt, uint grfAttrs, IntPtr pStgOptions, IntPtr pSecurityDescriptor, ref Guid riid, IntPtr ppObjectOpen);
"@
$api = Add-Type -MemberDefinition $sig -Name 'OLE32_StgOpenStorageEx' -Namespace Win32 -PassThru
# $api::StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, pStgOptions, pSecurityDescriptor, riid, ppObjectOpen)#uselib "OLE32.dll"
#func global StgOpenStorageEx "StgOpenStorageEx" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; StgOpenStorageEx pwcsName, grfMode, stgfmt, grfAttrs, varptr(pStgOptions), pSecurityDescriptor, varptr(riid), ppObjectOpen ; 戻り値は stat
; pwcsName : LPCWSTR -> "sptr"
; grfMode : STGM -> "sptr"
; stgfmt : STGFMT -> "sptr"
; grfAttrs : DWORD -> "sptr"
; pStgOptions : STGOPTIONS* optional, in/out -> "sptr"
; pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "sptr"
; riid : GUID* -> "sptr"
; ppObjectOpen : void** out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "OLE32.dll" #cfunc global StgOpenStorageEx "StgOpenStorageEx" wstr, int, int, int, var, sptr, var, sptr ; res = StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, pStgOptions, pSecurityDescriptor, riid, ppObjectOpen) ; pwcsName : LPCWSTR -> "wstr" ; grfMode : STGM -> "int" ; stgfmt : STGFMT -> "int" ; grfAttrs : DWORD -> "int" ; pStgOptions : STGOPTIONS* optional, in/out -> "var" ; pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "sptr" ; riid : GUID* -> "var" ; ppObjectOpen : void** out -> "sptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "OLE32.dll" #cfunc global StgOpenStorageEx "StgOpenStorageEx" wstr, int, int, int, sptr, sptr, sptr, sptr ; res = StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, varptr(pStgOptions), pSecurityDescriptor, varptr(riid), ppObjectOpen) ; pwcsName : LPCWSTR -> "wstr" ; grfMode : STGM -> "int" ; stgfmt : STGFMT -> "int" ; grfAttrs : DWORD -> "int" ; pStgOptions : STGOPTIONS* optional, in/out -> "sptr" ; pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "sptr" ; riid : GUID* -> "sptr" ; ppObjectOpen : void** out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT StgOpenStorageEx(LPCWSTR pwcsName, STGM grfMode, STGFMT stgfmt, DWORD grfAttrs, STGOPTIONS* pStgOptions, PSECURITY_DESCRIPTOR pSecurityDescriptor, GUID* riid, void** ppObjectOpen) #uselib "OLE32.dll" #cfunc global StgOpenStorageEx "StgOpenStorageEx" wstr, int, int, int, var, intptr, var, intptr ; res = StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, pStgOptions, pSecurityDescriptor, riid, ppObjectOpen) ; pwcsName : LPCWSTR -> "wstr" ; grfMode : STGM -> "int" ; stgfmt : STGFMT -> "int" ; grfAttrs : DWORD -> "int" ; pStgOptions : STGOPTIONS* optional, in/out -> "var" ; pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "intptr" ; riid : GUID* -> "var" ; ppObjectOpen : void** out -> "intptr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT StgOpenStorageEx(LPCWSTR pwcsName, STGM grfMode, STGFMT stgfmt, DWORD grfAttrs, STGOPTIONS* pStgOptions, PSECURITY_DESCRIPTOR pSecurityDescriptor, GUID* riid, void** ppObjectOpen) #uselib "OLE32.dll" #cfunc global StgOpenStorageEx "StgOpenStorageEx" wstr, int, int, int, intptr, intptr, intptr, intptr ; res = StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, varptr(pStgOptions), pSecurityDescriptor, varptr(riid), ppObjectOpen) ; pwcsName : LPCWSTR -> "wstr" ; grfMode : STGM -> "int" ; stgfmt : STGFMT -> "int" ; grfAttrs : DWORD -> "int" ; pStgOptions : STGOPTIONS* optional, in/out -> "intptr" ; pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "intptr" ; riid : GUID* -> "intptr" ; ppObjectOpen : void** out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
ole32 = windows.NewLazySystemDLL("OLE32.dll")
procStgOpenStorageEx = ole32.NewProc("StgOpenStorageEx")
)
// pwcsName (LPCWSTR), grfMode (STGM), stgfmt (STGFMT), grfAttrs (DWORD), pStgOptions (STGOPTIONS* optional, in/out), pSecurityDescriptor (PSECURITY_DESCRIPTOR optional), riid (GUID*), ppObjectOpen (void** out)
r1, _, err := procStgOpenStorageEx.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwcsName))),
uintptr(grfMode),
uintptr(stgfmt),
uintptr(grfAttrs),
uintptr(pStgOptions),
uintptr(pSecurityDescriptor),
uintptr(riid),
uintptr(ppObjectOpen),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction StgOpenStorageEx(
pwcsName: PWideChar; // LPCWSTR
grfMode: DWORD; // STGM
stgfmt: DWORD; // STGFMT
grfAttrs: DWORD; // DWORD
pStgOptions: Pointer; // STGOPTIONS* optional, in/out
pSecurityDescriptor: THandle; // PSECURITY_DESCRIPTOR optional
riid: PGUID; // GUID*
ppObjectOpen: Pointer // void** out
): Integer; stdcall;
external 'OLE32.dll' name 'StgOpenStorageEx';result := DllCall("OLE32\StgOpenStorageEx"
, "WStr", pwcsName ; LPCWSTR
, "UInt", grfMode ; STGM
, "UInt", stgfmt ; STGFMT
, "UInt", grfAttrs ; DWORD
, "Ptr", pStgOptions ; STGOPTIONS* optional, in/out
, "Ptr", pSecurityDescriptor ; PSECURITY_DESCRIPTOR optional
, "Ptr", riid ; GUID*
, "Ptr", ppObjectOpen ; void** out
, "Int") ; return: HRESULT●StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, pStgOptions, pSecurityDescriptor, riid, ppObjectOpen) = DLL("OLE32.dll", "int StgOpenStorageEx(char*, dword, dword, dword, void*, void*, void*, void*)")
# 呼び出し: StgOpenStorageEx(pwcsName, grfMode, stgfmt, grfAttrs, pStgOptions, pSecurityDescriptor, riid, ppObjectOpen)
# pwcsName : LPCWSTR -> "char*"
# grfMode : STGM -> "dword"
# stgfmt : STGFMT -> "dword"
# grfAttrs : DWORD -> "dword"
# pStgOptions : STGOPTIONS* optional, in/out -> "void*"
# pSecurityDescriptor : PSECURITY_DESCRIPTOR optional -> "void*"
# riid : GUID* -> "void*"
# ppObjectOpen : void** out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。