ホーム › Storage.Packaging.Appx › TryCreatePackageDependency
TryCreatePackageDependency
関数実行時に解決するパッケージ依存関係を定義し作成を試みる。
シグネチャ
// KERNELBASE.dll
#include <windows.h>
HRESULT TryCreatePackageDependency(
PSID user,
LPCWSTR packageFamilyName,
PACKAGE_VERSION minVersion,
PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
PackageDependencyLifetimeKind lifetimeKind,
LPCWSTR lifetimeArtifact,
CreatePackageDependencyOptions options,
LPWSTR* packageDependencyId
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| user | PSID | in |
| packageFamilyName | LPCWSTR | in |
| minVersion | PACKAGE_VERSION | in |
| packageDependencyProcessorArchitectures | PackageDependencyProcessorArchitectures | in |
| lifetimeKind | PackageDependencyLifetimeKind | in |
| lifetimeArtifact | LPCWSTR | in |
| options | CreatePackageDependencyOptions | in |
| packageDependencyId | LPWSTR* | out |
戻り値の型: HRESULT
各言語での呼び出し定義
// KERNELBASE.dll
#include <windows.h>
HRESULT TryCreatePackageDependency(
PSID user,
LPCWSTR packageFamilyName,
PACKAGE_VERSION minVersion,
PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
PackageDependencyLifetimeKind lifetimeKind,
LPCWSTR lifetimeArtifact,
CreatePackageDependencyOptions options,
LPWSTR* packageDependencyId
);[DllImport("KERNELBASE.dll", ExactSpelling = true)]
static extern int TryCreatePackageDependency(
IntPtr user, // PSID
[MarshalAs(UnmanagedType.LPWStr)] string packageFamilyName, // LPCWSTR
PACKAGE_VERSION minVersion, // PACKAGE_VERSION
int packageDependencyProcessorArchitectures, // PackageDependencyProcessorArchitectures
int lifetimeKind, // PackageDependencyLifetimeKind
[MarshalAs(UnmanagedType.LPWStr)] string lifetimeArtifact, // LPCWSTR
int options, // CreatePackageDependencyOptions
IntPtr packageDependencyId // LPWSTR* out
);<DllImport("KERNELBASE.dll", ExactSpelling:=True)>
Public Shared Function TryCreatePackageDependency(
user As IntPtr, ' PSID
<MarshalAs(UnmanagedType.LPWStr)> packageFamilyName As String, ' LPCWSTR
minVersion As PACKAGE_VERSION, ' PACKAGE_VERSION
packageDependencyProcessorArchitectures As Integer, ' PackageDependencyProcessorArchitectures
lifetimeKind As Integer, ' PackageDependencyLifetimeKind
<MarshalAs(UnmanagedType.LPWStr)> lifetimeArtifact As String, ' LPCWSTR
options As Integer, ' CreatePackageDependencyOptions
packageDependencyId As IntPtr ' LPWSTR* out
) As Integer
End Function' user : PSID
' packageFamilyName : LPCWSTR
' minVersion : PACKAGE_VERSION
' packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures
' lifetimeKind : PackageDependencyLifetimeKind
' lifetimeArtifact : LPCWSTR
' options : CreatePackageDependencyOptions
' packageDependencyId : LPWSTR* out
Declare PtrSafe Function TryCreatePackageDependency Lib "kernelbase" ( _
ByVal user As LongPtr, _
ByVal packageFamilyName As LongPtr, _
ByVal minVersion As LongPtr, _
ByVal packageDependencyProcessorArchitectures As Long, _
ByVal lifetimeKind As Long, _
ByVal lifetimeArtifact As LongPtr, _
ByVal options As Long, _
ByVal packageDependencyId As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
TryCreatePackageDependency = ctypes.windll.kernelbase.TryCreatePackageDependency
TryCreatePackageDependency.restype = ctypes.c_int
TryCreatePackageDependency.argtypes = [
wintypes.HANDLE, # user : PSID
wintypes.LPCWSTR, # packageFamilyName : LPCWSTR
PACKAGE_VERSION, # minVersion : PACKAGE_VERSION
ctypes.c_int, # packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures
ctypes.c_int, # lifetimeKind : PackageDependencyLifetimeKind
wintypes.LPCWSTR, # lifetimeArtifact : LPCWSTR
ctypes.c_int, # options : CreatePackageDependencyOptions
ctypes.c_void_p, # packageDependencyId : LPWSTR* out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('KERNELBASE.dll')
TryCreatePackageDependency = Fiddle::Function.new(
lib['TryCreatePackageDependency'],
[
Fiddle::TYPE_VOIDP, # user : PSID
Fiddle::TYPE_VOIDP, # packageFamilyName : LPCWSTR
Fiddle::TYPE_VOIDP, # minVersion : PACKAGE_VERSION
Fiddle::TYPE_INT, # packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures
Fiddle::TYPE_INT, # lifetimeKind : PackageDependencyLifetimeKind
Fiddle::TYPE_VOIDP, # lifetimeArtifact : LPCWSTR
Fiddle::TYPE_INT, # options : CreatePackageDependencyOptions
Fiddle::TYPE_VOIDP, # packageDependencyId : LPWSTR* out
],
Fiddle::TYPE_INT)#[link(name = "kernelbase")]
extern "system" {
fn TryCreatePackageDependency(
user: *mut core::ffi::c_void, // PSID
packageFamilyName: *const u16, // LPCWSTR
minVersion: PACKAGE_VERSION, // PACKAGE_VERSION
packageDependencyProcessorArchitectures: i32, // PackageDependencyProcessorArchitectures
lifetimeKind: i32, // PackageDependencyLifetimeKind
lifetimeArtifact: *const u16, // LPCWSTR
options: i32, // CreatePackageDependencyOptions
packageDependencyId: *mut *mut u16 // LPWSTR* out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("KERNELBASE.dll")]
public static extern int TryCreatePackageDependency(IntPtr user, [MarshalAs(UnmanagedType.LPWStr)] string packageFamilyName, PACKAGE_VERSION minVersion, int packageDependencyProcessorArchitectures, int lifetimeKind, [MarshalAs(UnmanagedType.LPWStr)] string lifetimeArtifact, int options, IntPtr packageDependencyId);
"@
$api = Add-Type -MemberDefinition $sig -Name 'KERNELBASE_TryCreatePackageDependency' -Namespace Win32 -PassThru
# $api::TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, packageDependencyId)#uselib "KERNELBASE.dll"
#func global TryCreatePackageDependency "TryCreatePackageDependency" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; TryCreatePackageDependency user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, varptr(packageDependencyId) ; 戻り値は stat
; user : PSID -> "sptr"
; packageFamilyName : LPCWSTR -> "sptr"
; minVersion : PACKAGE_VERSION -> "sptr"
; packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "sptr"
; lifetimeKind : PackageDependencyLifetimeKind -> "sptr"
; lifetimeArtifact : LPCWSTR -> "sptr"
; options : CreatePackageDependencyOptions -> "sptr"
; packageDependencyId : LPWSTR* out -> "sptr"
; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "KERNELBASE.dll" #cfunc global TryCreatePackageDependency "TryCreatePackageDependency" sptr, wstr, int, int, int, wstr, int, var ; res = TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, packageDependencyId) ; user : PSID -> "sptr" ; packageFamilyName : LPCWSTR -> "wstr" ; minVersion : PACKAGE_VERSION -> "int" ; packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "int" ; lifetimeKind : PackageDependencyLifetimeKind -> "int" ; lifetimeArtifact : LPCWSTR -> "wstr" ; options : CreatePackageDependencyOptions -> "int" ; packageDependencyId : LPWSTR* out -> "var" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "KERNELBASE.dll" #cfunc global TryCreatePackageDependency "TryCreatePackageDependency" sptr, wstr, int, int, int, wstr, int, sptr ; res = TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, varptr(packageDependencyId)) ; user : PSID -> "sptr" ; packageFamilyName : LPCWSTR -> "wstr" ; minVersion : PACKAGE_VERSION -> "int" ; packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "int" ; lifetimeKind : PackageDependencyLifetimeKind -> "int" ; lifetimeArtifact : LPCWSTR -> "wstr" ; options : CreatePackageDependencyOptions -> "int" ; packageDependencyId : LPWSTR* out -> "sptr" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT TryCreatePackageDependency(PSID user, LPCWSTR packageFamilyName, PACKAGE_VERSION minVersion, PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures, PackageDependencyLifetimeKind lifetimeKind, LPCWSTR lifetimeArtifact, CreatePackageDependencyOptions options, LPWSTR* packageDependencyId) #uselib "KERNELBASE.dll" #cfunc global TryCreatePackageDependency "TryCreatePackageDependency" intptr, wstr, int, int, int, wstr, int, var ; res = TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, packageDependencyId) ; user : PSID -> "intptr" ; packageFamilyName : LPCWSTR -> "wstr" ; minVersion : PACKAGE_VERSION -> "int" ; packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "int" ; lifetimeKind : PackageDependencyLifetimeKind -> "int" ; lifetimeArtifact : LPCWSTR -> "wstr" ; options : CreatePackageDependencyOptions -> "int" ; packageDependencyId : LPWSTR* out -> "var" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT TryCreatePackageDependency(PSID user, LPCWSTR packageFamilyName, PACKAGE_VERSION minVersion, PackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures, PackageDependencyLifetimeKind lifetimeKind, LPCWSTR lifetimeArtifact, CreatePackageDependencyOptions options, LPWSTR* packageDependencyId) #uselib "KERNELBASE.dll" #cfunc global TryCreatePackageDependency "TryCreatePackageDependency" intptr, wstr, int, int, int, wstr, int, intptr ; res = TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, varptr(packageDependencyId)) ; user : PSID -> "intptr" ; packageFamilyName : LPCWSTR -> "wstr" ; minVersion : PACKAGE_VERSION -> "int" ; packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "int" ; lifetimeKind : PackageDependencyLifetimeKind -> "int" ; lifetimeArtifact : LPCWSTR -> "wstr" ; options : CreatePackageDependencyOptions -> "int" ; packageDependencyId : LPWSTR* out -> "intptr" ; ※値渡し構造体は直接渡せません。intにパック、または var で構造体変数を渡してください。 ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
kernelbase = windows.NewLazySystemDLL("KERNELBASE.dll")
procTryCreatePackageDependency = kernelbase.NewProc("TryCreatePackageDependency")
)
// user (PSID), packageFamilyName (LPCWSTR), minVersion (PACKAGE_VERSION), packageDependencyProcessorArchitectures (PackageDependencyProcessorArchitectures), lifetimeKind (PackageDependencyLifetimeKind), lifetimeArtifact (LPCWSTR), options (CreatePackageDependencyOptions), packageDependencyId (LPWSTR* out)
r1, _, err := procTryCreatePackageDependency.Call(
uintptr(user),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(packageFamilyName))),
uintptr(minVersion),
uintptr(packageDependencyProcessorArchitectures),
uintptr(lifetimeKind),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(lifetimeArtifact))),
uintptr(options),
uintptr(packageDependencyId),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction TryCreatePackageDependency(
user: THandle; // PSID
packageFamilyName: PWideChar; // LPCWSTR
minVersion: PACKAGE_VERSION; // PACKAGE_VERSION
packageDependencyProcessorArchitectures: Integer; // PackageDependencyProcessorArchitectures
lifetimeKind: Integer; // PackageDependencyLifetimeKind
lifetimeArtifact: PWideChar; // LPCWSTR
options: Integer; // CreatePackageDependencyOptions
packageDependencyId: PPWideChar // LPWSTR* out
): Integer; stdcall;
external 'KERNELBASE.dll' name 'TryCreatePackageDependency';result := DllCall("KERNELBASE\TryCreatePackageDependency"
, "Ptr", user ; PSID
, "WStr", packageFamilyName ; LPCWSTR
, "Ptr", minVersion ; PACKAGE_VERSION
, "Int", packageDependencyProcessorArchitectures ; PackageDependencyProcessorArchitectures
, "Int", lifetimeKind ; PackageDependencyLifetimeKind
, "WStr", lifetimeArtifact ; LPCWSTR
, "Int", options ; CreatePackageDependencyOptions
, "Ptr", packageDependencyId ; LPWSTR* out
, "Int") ; return: HRESULT●TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, packageDependencyId) = DLL("KERNELBASE.dll", "int TryCreatePackageDependency(void*, char*, void*, int, int, char*, int, void*)")
# 呼び出し: TryCreatePackageDependency(user, packageFamilyName, minVersion, packageDependencyProcessorArchitectures, lifetimeKind, lifetimeArtifact, options, packageDependencyId)
# user : PSID -> "void*"
# packageFamilyName : LPCWSTR -> "char*"
# minVersion : PACKAGE_VERSION -> "void*"
# packageDependencyProcessorArchitectures : PackageDependencyProcessorArchitectures -> "int"
# lifetimeKind : PackageDependencyLifetimeKind -> "int"
# lifetimeArtifact : LPCWSTR -> "char*"
# options : CreatePackageDependencyOptions -> "int"
# packageDependencyId : LPWSTR* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。