ホーム › Networking.Clustering › RegisterAppInstanceVersion

RegisterAppInstanceVersion

関数

アプリインスタンスのバージョン番号を登録する。

DLLNTLANMAN.dll呼出規約winapi

シグネチャ

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

DWORD RegisterAppInstanceVersion(
    GUID* AppInstanceId,
    ULONGLONG InstanceVersionHigh,
    ULONGLONG InstanceVersionLow
);

パラメーター

名前	型	方向	説明
AppInstanceId	GUID*	in	バージョンを登録する対象アプリインスタンス識別子(GUID)へのポインター。
InstanceVersionHigh	ULONGLONG	in	インスタンスバージョン番号の上位64ビット。
InstanceVersionLow	ULONGLONG	in	インスタンスバージョン番号の下位64ビット。

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD RegisterAppInstanceVersion(
    GUID* AppInstanceId,
    ULONGLONG InstanceVersionHigh,
    ULONGLONG InstanceVersionLow
);

[DllImport("NTLANMAN.dll", ExactSpelling = true)]
static extern uint RegisterAppInstanceVersion(
    ref Guid AppInstanceId,   // GUID*
    ulong InstanceVersionHigh,   // ULONGLONG
    ulong InstanceVersionLow   // ULONGLONG
);

<DllImport("NTLANMAN.dll", ExactSpelling:=True)>
Public Shared Function RegisterAppInstanceVersion(
    ByRef AppInstanceId As Guid,   ' GUID*
    InstanceVersionHigh As ULong,   ' ULONGLONG
    InstanceVersionLow As ULong   ' ULONGLONG
) As UInteger
End Function

' AppInstanceId : GUID*
' InstanceVersionHigh : ULONGLONG
' InstanceVersionLow : ULONGLONG
Declare PtrSafe Function RegisterAppInstanceVersion Lib "ntlanman" ( _
    ByVal AppInstanceId As LongPtr, _
    ByVal InstanceVersionHigh As LongLong, _
    ByVal InstanceVersionLow As LongLong) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

RegisterAppInstanceVersion = ctypes.windll.ntlanman.RegisterAppInstanceVersion
RegisterAppInstanceVersion.restype = wintypes.DWORD
RegisterAppInstanceVersion.argtypes = [
    ctypes.c_void_p,  # AppInstanceId : GUID*
    ctypes.c_ulonglong,  # InstanceVersionHigh : ULONGLONG
    ctypes.c_ulonglong,  # InstanceVersionLow : ULONGLONG
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('NTLANMAN.dll')
RegisterAppInstanceVersion = Fiddle::Function.new(
  lib['RegisterAppInstanceVersion'],
  [
    Fiddle::TYPE_VOIDP,  # AppInstanceId : GUID*
    -Fiddle::TYPE_LONG_LONG,  # InstanceVersionHigh : ULONGLONG
    -Fiddle::TYPE_LONG_LONG,  # InstanceVersionLow : ULONGLONG
  ],
  -Fiddle::TYPE_INT)

#[link(name = "ntlanman")]
extern "system" {
    fn RegisterAppInstanceVersion(
        AppInstanceId: *mut GUID,  // GUID*
        InstanceVersionHigh: u64,  // ULONGLONG
        InstanceVersionLow: u64  // ULONGLONG
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("NTLANMAN.dll")]
public static extern uint RegisterAppInstanceVersion(ref Guid AppInstanceId, ulong InstanceVersionHigh, ulong InstanceVersionLow);
"@
$api = Add-Type -MemberDefinition $sig -Name 'NTLANMAN_RegisterAppInstanceVersion' -Namespace Win32 -PassThru
# $api::RegisterAppInstanceVersion(AppInstanceId, InstanceVersionHigh, InstanceVersionLow)

#uselib "NTLANMAN.dll"
#func global RegisterAppInstanceVersion "RegisterAppInstanceVersion" sptr, sptr, sptr
; RegisterAppInstanceVersion varptr(AppInstanceId), InstanceVersionHigh, InstanceVersionLow   ; 戻り値は stat
; AppInstanceId : GUID* -> "sptr"
; InstanceVersionHigh : ULONGLONG -> "sptr"
; InstanceVersionLow : ULONGLONG -> "sptr"
; ※HSP3.7は int64 引数(64bit値渡し)に非対応です。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "NTLANMAN.dll"
#cfunc global RegisterAppInstanceVersion "RegisterAppInstanceVersion" var, int64, int64
; res = RegisterAppInstanceVersion(AppInstanceId, InstanceVersionHigh, InstanceVersionLow)
; AppInstanceId : GUID* -> "var"
; InstanceVersionHigh : ULONGLONG -> "int64"
; InstanceVersionLow : ULONGLONG -> "int64"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。#uselib "NTLANMAN.dll"
#cfunc global RegisterAppInstanceVersion "RegisterAppInstanceVersion" sptr, int64, int64
; res = RegisterAppInstanceVersion(varptr(AppInstanceId), InstanceVersionHigh, InstanceVersionLow)
; AppInstanceId : GUID* -> "sptr"
; InstanceVersionHigh : ULONGLONG -> "int64"
; InstanceVersionLow : ULONGLONG -> "int64"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。

出力引数:

; DWORD RegisterAppInstanceVersion(GUID* AppInstanceId, ULONGLONG InstanceVersionHigh, ULONGLONG InstanceVersionLow)
#uselib "NTLANMAN.dll"
#cfunc global RegisterAppInstanceVersion "RegisterAppInstanceVersion" var, int64, int64
; res = RegisterAppInstanceVersion(AppInstanceId, InstanceVersionHigh, InstanceVersionLow)
; AppInstanceId : GUID* -> "var"
; InstanceVersionHigh : ULONGLONG -> "int64"
; InstanceVersionLow : ULONGLONG -> "int64"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD RegisterAppInstanceVersion(GUID* AppInstanceId, ULONGLONG InstanceVersionHigh, ULONGLONG InstanceVersionLow)
#uselib "NTLANMAN.dll"
#cfunc global RegisterAppInstanceVersion "RegisterAppInstanceVersion" intptr, int64, int64
; res = RegisterAppInstanceVersion(varptr(AppInstanceId), InstanceVersionHigh, InstanceVersionLow)
; AppInstanceId : GUID* -> "intptr"
; InstanceVersionHigh : ULONGLONG -> "int64"
; InstanceVersionLow : ULONGLONG -> "int64"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	ntlanman = windows.NewLazySystemDLL("NTLANMAN.dll")
	procRegisterAppInstanceVersion = ntlanman.NewProc("RegisterAppInstanceVersion")
)

// AppInstanceId (GUID*), InstanceVersionHigh (ULONGLONG), InstanceVersionLow (ULONGLONG)
r1, _, err := procRegisterAppInstanceVersion.Call(
	uintptr(AppInstanceId),
	uintptr(InstanceVersionHigh),
	uintptr(InstanceVersionLow),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function RegisterAppInstanceVersion(
  AppInstanceId: PGUID;   // GUID*
  InstanceVersionHigh: UInt64;   // ULONGLONG
  InstanceVersionLow: UInt64   // ULONGLONG
): DWORD; stdcall;
  external 'NTLANMAN.dll' name 'RegisterAppInstanceVersion';

result := DllCall("NTLANMAN\RegisterAppInstanceVersion"
    , "Ptr", AppInstanceId   ; GUID*
    , "Int64", InstanceVersionHigh   ; ULONGLONG
    , "Int64", InstanceVersionLow   ; ULONGLONG
    , "UInt")   ; return: DWORD

●RegisterAppInstanceVersion(AppInstanceId, InstanceVersionHigh, InstanceVersionLow) = DLL("NTLANMAN.dll", "dword RegisterAppInstanceVersion(void*, qword, qword)")
# 呼び出し: RegisterAppInstanceVersion(AppInstanceId, InstanceVersionHigh, InstanceVersionLow)
# AppInstanceId : GUID* -> "void*"
# InstanceVersionHigh : ULONGLONG -> "qword"
# InstanceVersionLow : ULONGLONG -> "qword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。