ホーム › System.RemoteManagement › WSManPluginAuthzUserComplete

WSManPluginAuthzUserComplete

関数

プラグインのユーザー認可処理の完了を通知する。

DLLWsmSvc.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

DWORD WSManPluginAuthzUserComplete(
    WSMAN_SENDER_DETAILS* senderDetails,
    DWORD flags,
    void* userAuthorizationContext,   // optional
    HANDLE impersonationToken,   // optional
    BOOL userIsAdministrator,
    DWORD errorCode,
    LPCWSTR extendedErrorInformation   // optional
);

パラメーター

名前	型	方向
senderDetails	WSMAN_SENDER_DETAILS*	in
flags	DWORD	in
userAuthorizationContext	void*	inoptional
impersonationToken	HANDLE	inoptional
userIsAdministrator	BOOL	in
errorCode	DWORD	in
extendedErrorInformation	LPCWSTR	inoptional

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD WSManPluginAuthzUserComplete(
    WSMAN_SENDER_DETAILS* senderDetails,
    DWORD flags,
    void* userAuthorizationContext,   // optional
    HANDLE impersonationToken,   // optional
    BOOL userIsAdministrator,
    DWORD errorCode,
    LPCWSTR extendedErrorInformation   // optional
);

[DllImport("WsmSvc.dll", ExactSpelling = true)]
static extern uint WSManPluginAuthzUserComplete(
    IntPtr senderDetails,   // WSMAN_SENDER_DETAILS*
    uint flags,   // DWORD
    IntPtr userAuthorizationContext,   // void* optional
    IntPtr impersonationToken,   // HANDLE optional
    bool userIsAdministrator,   // BOOL
    uint errorCode,   // DWORD
    [MarshalAs(UnmanagedType.LPWStr)] string extendedErrorInformation   // LPCWSTR optional
);

<DllImport("WsmSvc.dll", ExactSpelling:=True)>
Public Shared Function WSManPluginAuthzUserComplete(
    senderDetails As IntPtr,   ' WSMAN_SENDER_DETAILS*
    flags As UInteger,   ' DWORD
    userAuthorizationContext As IntPtr,   ' void* optional
    impersonationToken As IntPtr,   ' HANDLE optional
    userIsAdministrator As Boolean,   ' BOOL
    errorCode As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPWStr)> extendedErrorInformation As String   ' LPCWSTR optional
) As UInteger
End Function

' senderDetails : WSMAN_SENDER_DETAILS*
' flags : DWORD
' userAuthorizationContext : void* optional
' impersonationToken : HANDLE optional
' userIsAdministrator : BOOL
' errorCode : DWORD
' extendedErrorInformation : LPCWSTR optional
Declare PtrSafe Function WSManPluginAuthzUserComplete Lib "wsmsvc" ( _
    ByVal senderDetails As LongPtr, _
    ByVal flags As Long, _
    ByVal userAuthorizationContext As LongPtr, _
    ByVal impersonationToken As LongPtr, _
    ByVal userIsAdministrator As Long, _
    ByVal errorCode As Long, _
    ByVal extendedErrorInformation As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WSManPluginAuthzUserComplete = ctypes.windll.wsmsvc.WSManPluginAuthzUserComplete
WSManPluginAuthzUserComplete.restype = wintypes.DWORD
WSManPluginAuthzUserComplete.argtypes = [
    ctypes.c_void_p,  # senderDetails : WSMAN_SENDER_DETAILS*
    wintypes.DWORD,  # flags : DWORD
    ctypes.POINTER(None),  # userAuthorizationContext : void* optional
    wintypes.HANDLE,  # impersonationToken : HANDLE optional
    wintypes.BOOL,  # userIsAdministrator : BOOL
    wintypes.DWORD,  # errorCode : DWORD
    wintypes.LPCWSTR,  # extendedErrorInformation : LPCWSTR optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WsmSvc.dll')
WSManPluginAuthzUserComplete = Fiddle::Function.new(
  lib['WSManPluginAuthzUserComplete'],
  [
    Fiddle::TYPE_VOIDP,  # senderDetails : WSMAN_SENDER_DETAILS*
    -Fiddle::TYPE_INT,  # flags : DWORD
    Fiddle::TYPE_VOIDP,  # userAuthorizationContext : void* optional
    Fiddle::TYPE_VOIDP,  # impersonationToken : HANDLE optional
    Fiddle::TYPE_INT,  # userIsAdministrator : BOOL
    -Fiddle::TYPE_INT,  # errorCode : DWORD
    Fiddle::TYPE_VOIDP,  # extendedErrorInformation : LPCWSTR optional
  ],
  -Fiddle::TYPE_INT)

#[link(name = "wsmsvc")]
extern "system" {
    fn WSManPluginAuthzUserComplete(
        senderDetails: *mut WSMAN_SENDER_DETAILS,  // WSMAN_SENDER_DETAILS*
        flags: u32,  // DWORD
        userAuthorizationContext: *mut (),  // void* optional
        impersonationToken: *mut core::ffi::c_void,  // HANDLE optional
        userIsAdministrator: i32,  // BOOL
        errorCode: u32,  // DWORD
        extendedErrorInformation: *const u16  // LPCWSTR optional
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("WsmSvc.dll")]
public static extern uint WSManPluginAuthzUserComplete(IntPtr senderDetails, uint flags, IntPtr userAuthorizationContext, IntPtr impersonationToken, bool userIsAdministrator, uint errorCode, [MarshalAs(UnmanagedType.LPWStr)] string extendedErrorInformation);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WsmSvc_WSManPluginAuthzUserComplete' -Namespace Win32 -PassThru
# $api::WSManPluginAuthzUserComplete(senderDetails, flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)

#uselib "WsmSvc.dll"
#func global WSManPluginAuthzUserComplete "WSManPluginAuthzUserComplete" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WSManPluginAuthzUserComplete varptr(senderDetails), flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation   ; 戻り値は stat
; senderDetails : WSMAN_SENDER_DETAILS* -> "sptr"
; flags : DWORD -> "sptr"
; userAuthorizationContext : void* optional -> "sptr"
; impersonationToken : HANDLE optional -> "sptr"
; userIsAdministrator : BOOL -> "sptr"
; errorCode : DWORD -> "sptr"
; extendedErrorInformation : LPCWSTR optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "WsmSvc.dll"
#cfunc global WSManPluginAuthzUserComplete "WSManPluginAuthzUserComplete" var, int, sptr, sptr, int, int, wstr
; res = WSManPluginAuthzUserComplete(senderDetails, flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)
; senderDetails : WSMAN_SENDER_DETAILS* -> "var"
; flags : DWORD -> "int"
; userAuthorizationContext : void* optional -> "sptr"
; impersonationToken : HANDLE optional -> "sptr"
; userIsAdministrator : BOOL -> "int"
; errorCode : DWORD -> "int"
; extendedErrorInformation : LPCWSTR optional -> "wstr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "WsmSvc.dll"
#cfunc global WSManPluginAuthzUserComplete "WSManPluginAuthzUserComplete" sptr, int, sptr, sptr, int, int, wstr
; res = WSManPluginAuthzUserComplete(varptr(senderDetails), flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)
; senderDetails : WSMAN_SENDER_DETAILS* -> "sptr"
; flags : DWORD -> "int"
; userAuthorizationContext : void* optional -> "sptr"
; impersonationToken : HANDLE optional -> "sptr"
; userIsAdministrator : BOOL -> "int"
; errorCode : DWORD -> "int"
; extendedErrorInformation : LPCWSTR optional -> "wstr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; DWORD WSManPluginAuthzUserComplete(WSMAN_SENDER_DETAILS* senderDetails, DWORD flags, void* userAuthorizationContext, HANDLE impersonationToken, BOOL userIsAdministrator, DWORD errorCode, LPCWSTR extendedErrorInformation)
#uselib "WsmSvc.dll"
#cfunc global WSManPluginAuthzUserComplete "WSManPluginAuthzUserComplete" var, int, intptr, intptr, int, int, wstr
; res = WSManPluginAuthzUserComplete(senderDetails, flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)
; senderDetails : WSMAN_SENDER_DETAILS* -> "var"
; flags : DWORD -> "int"
; userAuthorizationContext : void* optional -> "intptr"
; impersonationToken : HANDLE optional -> "intptr"
; userIsAdministrator : BOOL -> "int"
; errorCode : DWORD -> "int"
; extendedErrorInformation : LPCWSTR optional -> "wstr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD WSManPluginAuthzUserComplete(WSMAN_SENDER_DETAILS* senderDetails, DWORD flags, void* userAuthorizationContext, HANDLE impersonationToken, BOOL userIsAdministrator, DWORD errorCode, LPCWSTR extendedErrorInformation)
#uselib "WsmSvc.dll"
#cfunc global WSManPluginAuthzUserComplete "WSManPluginAuthzUserComplete" intptr, int, intptr, intptr, int, int, wstr
; res = WSManPluginAuthzUserComplete(varptr(senderDetails), flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)
; senderDetails : WSMAN_SENDER_DETAILS* -> "intptr"
; flags : DWORD -> "int"
; userAuthorizationContext : void* optional -> "intptr"
; impersonationToken : HANDLE optional -> "intptr"
; userIsAdministrator : BOOL -> "int"
; errorCode : DWORD -> "int"
; extendedErrorInformation : LPCWSTR optional -> "wstr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	wsmsvc = windows.NewLazySystemDLL("WsmSvc.dll")
	procWSManPluginAuthzUserComplete = wsmsvc.NewProc("WSManPluginAuthzUserComplete")
)

// senderDetails (WSMAN_SENDER_DETAILS*), flags (DWORD), userAuthorizationContext (void* optional), impersonationToken (HANDLE optional), userIsAdministrator (BOOL), errorCode (DWORD), extendedErrorInformation (LPCWSTR optional)
r1, _, err := procWSManPluginAuthzUserComplete.Call(
	uintptr(senderDetails),
	uintptr(flags),
	uintptr(userAuthorizationContext),
	uintptr(impersonationToken),
	uintptr(userIsAdministrator),
	uintptr(errorCode),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(extendedErrorInformation))),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function WSManPluginAuthzUserComplete(
  senderDetails: Pointer;   // WSMAN_SENDER_DETAILS*
  flags: DWORD;   // DWORD
  userAuthorizationContext: Pointer;   // void* optional
  impersonationToken: THandle;   // HANDLE optional
  userIsAdministrator: BOOL;   // BOOL
  errorCode: DWORD;   // DWORD
  extendedErrorInformation: PWideChar   // LPCWSTR optional
): DWORD; stdcall;
  external 'WsmSvc.dll' name 'WSManPluginAuthzUserComplete';

result := DllCall("WsmSvc\WSManPluginAuthzUserComplete"
    , "Ptr", senderDetails   ; WSMAN_SENDER_DETAILS*
    , "UInt", flags   ; DWORD
    , "Ptr", userAuthorizationContext   ; void* optional
    , "Ptr", impersonationToken   ; HANDLE optional
    , "Int", userIsAdministrator   ; BOOL
    , "UInt", errorCode   ; DWORD
    , "WStr", extendedErrorInformation   ; LPCWSTR optional
    , "UInt")   ; return: DWORD

●WSManPluginAuthzUserComplete(senderDetails, flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation) = DLL("WsmSvc.dll", "dword WSManPluginAuthzUserComplete(void*, dword, void*, void*, bool, dword, char*)")
# 呼び出し: WSManPluginAuthzUserComplete(senderDetails, flags, userAuthorizationContext, impersonationToken, userIsAdministrator, errorCode, extendedErrorInformation)
# senderDetails : WSMAN_SENDER_DETAILS* -> "void*"
# flags : DWORD -> "dword"
# userAuthorizationContext : void* optional -> "void*"
# impersonationToken : HANDLE optional -> "void*"
# userIsAdministrator : BOOL -> "bool"
# errorCode : DWORD -> "dword"
# extendedErrorInformation : LPCWSTR optional -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。