ホーム › Security.Authentication.Identity › SLAcquireGenuineTicket
SLAcquireGenuineTicket
関数サーバーから正規品検証用のチケットBlobを取得する。
シグネチャ
// slcext.dll
#include <windows.h>
HRESULT SLAcquireGenuineTicket(
void** ppTicketBlob,
DWORD* pcbTicketBlob,
LPCWSTR pwszTemplateId,
LPCWSTR pwszServerUrl,
LPCWSTR pwszClientToken // optional
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| ppTicketBlob | void** | out |
| pcbTicketBlob | DWORD* | out |
| pwszTemplateId | LPCWSTR | in |
| pwszServerUrl | LPCWSTR | in |
| pwszClientToken | LPCWSTR | inoptional |
戻り値の型: HRESULT
各言語での呼び出し定義
// slcext.dll
#include <windows.h>
HRESULT SLAcquireGenuineTicket(
void** ppTicketBlob,
DWORD* pcbTicketBlob,
LPCWSTR pwszTemplateId,
LPCWSTR pwszServerUrl,
LPCWSTR pwszClientToken // optional
);[DllImport("slcext.dll", ExactSpelling = true)]
static extern int SLAcquireGenuineTicket(
IntPtr ppTicketBlob, // void** out
out uint pcbTicketBlob, // DWORD* out
[MarshalAs(UnmanagedType.LPWStr)] string pwszTemplateId, // LPCWSTR
[MarshalAs(UnmanagedType.LPWStr)] string pwszServerUrl, // LPCWSTR
[MarshalAs(UnmanagedType.LPWStr)] string pwszClientToken // LPCWSTR optional
);<DllImport("slcext.dll", ExactSpelling:=True)>
Public Shared Function SLAcquireGenuineTicket(
ppTicketBlob As IntPtr, ' void** out
<Out> ByRef pcbTicketBlob As UInteger, ' DWORD* out
<MarshalAs(UnmanagedType.LPWStr)> pwszTemplateId As String, ' LPCWSTR
<MarshalAs(UnmanagedType.LPWStr)> pwszServerUrl As String, ' LPCWSTR
<MarshalAs(UnmanagedType.LPWStr)> pwszClientToken As String ' LPCWSTR optional
) As Integer
End Function' ppTicketBlob : void** out
' pcbTicketBlob : DWORD* out
' pwszTemplateId : LPCWSTR
' pwszServerUrl : LPCWSTR
' pwszClientToken : LPCWSTR optional
Declare PtrSafe Function SLAcquireGenuineTicket Lib "slcext" ( _
ByVal ppTicketBlob As LongPtr, _
ByRef pcbTicketBlob As Long, _
ByVal pwszTemplateId As LongPtr, _
ByVal pwszServerUrl As LongPtr, _
ByVal pwszClientToken As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
SLAcquireGenuineTicket = ctypes.windll.slcext.SLAcquireGenuineTicket
SLAcquireGenuineTicket.restype = ctypes.c_int
SLAcquireGenuineTicket.argtypes = [
ctypes.c_void_p, # ppTicketBlob : void** out
ctypes.POINTER(wintypes.DWORD), # pcbTicketBlob : DWORD* out
wintypes.LPCWSTR, # pwszTemplateId : LPCWSTR
wintypes.LPCWSTR, # pwszServerUrl : LPCWSTR
wintypes.LPCWSTR, # pwszClientToken : LPCWSTR optional
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('slcext.dll')
SLAcquireGenuineTicket = Fiddle::Function.new(
lib['SLAcquireGenuineTicket'],
[
Fiddle::TYPE_VOIDP, # ppTicketBlob : void** out
Fiddle::TYPE_VOIDP, # pcbTicketBlob : DWORD* out
Fiddle::TYPE_VOIDP, # pwszTemplateId : LPCWSTR
Fiddle::TYPE_VOIDP, # pwszServerUrl : LPCWSTR
Fiddle::TYPE_VOIDP, # pwszClientToken : LPCWSTR optional
],
Fiddle::TYPE_INT)#[link(name = "slcext")]
extern "system" {
fn SLAcquireGenuineTicket(
ppTicketBlob: *mut *mut (), // void** out
pcbTicketBlob: *mut u32, // DWORD* out
pwszTemplateId: *const u16, // LPCWSTR
pwszServerUrl: *const u16, // LPCWSTR
pwszClientToken: *const u16 // LPCWSTR optional
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("slcext.dll")]
public static extern int SLAcquireGenuineTicket(IntPtr ppTicketBlob, out uint pcbTicketBlob, [MarshalAs(UnmanagedType.LPWStr)] string pwszTemplateId, [MarshalAs(UnmanagedType.LPWStr)] string pwszServerUrl, [MarshalAs(UnmanagedType.LPWStr)] string pwszClientToken);
"@
$api = Add-Type -MemberDefinition $sig -Name 'slcext_SLAcquireGenuineTicket' -Namespace Win32 -PassThru
# $api::SLAcquireGenuineTicket(ppTicketBlob, pcbTicketBlob, pwszTemplateId, pwszServerUrl, pwszClientToken)#uselib "slcext.dll"
#func global SLAcquireGenuineTicket "SLAcquireGenuineTicket" sptr, sptr, sptr, sptr, sptr
; SLAcquireGenuineTicket ppTicketBlob, varptr(pcbTicketBlob), pwszTemplateId, pwszServerUrl, pwszClientToken ; 戻り値は stat
; ppTicketBlob : void** out -> "sptr"
; pcbTicketBlob : DWORD* out -> "sptr"
; pwszTemplateId : LPCWSTR -> "sptr"
; pwszServerUrl : LPCWSTR -> "sptr"
; pwszClientToken : LPCWSTR optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "slcext.dll" #cfunc global SLAcquireGenuineTicket "SLAcquireGenuineTicket" sptr, var, wstr, wstr, wstr ; res = SLAcquireGenuineTicket(ppTicketBlob, pcbTicketBlob, pwszTemplateId, pwszServerUrl, pwszClientToken) ; ppTicketBlob : void** out -> "sptr" ; pcbTicketBlob : DWORD* out -> "var" ; pwszTemplateId : LPCWSTR -> "wstr" ; pwszServerUrl : LPCWSTR -> "wstr" ; pwszClientToken : LPCWSTR optional -> "wstr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "slcext.dll" #cfunc global SLAcquireGenuineTicket "SLAcquireGenuineTicket" sptr, sptr, wstr, wstr, wstr ; res = SLAcquireGenuineTicket(ppTicketBlob, varptr(pcbTicketBlob), pwszTemplateId, pwszServerUrl, pwszClientToken) ; ppTicketBlob : void** out -> "sptr" ; pcbTicketBlob : DWORD* out -> "sptr" ; pwszTemplateId : LPCWSTR -> "wstr" ; pwszServerUrl : LPCWSTR -> "wstr" ; pwszClientToken : LPCWSTR optional -> "wstr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT SLAcquireGenuineTicket(void** ppTicketBlob, DWORD* pcbTicketBlob, LPCWSTR pwszTemplateId, LPCWSTR pwszServerUrl, LPCWSTR pwszClientToken) #uselib "slcext.dll" #cfunc global SLAcquireGenuineTicket "SLAcquireGenuineTicket" intptr, var, wstr, wstr, wstr ; res = SLAcquireGenuineTicket(ppTicketBlob, pcbTicketBlob, pwszTemplateId, pwszServerUrl, pwszClientToken) ; ppTicketBlob : void** out -> "intptr" ; pcbTicketBlob : DWORD* out -> "var" ; pwszTemplateId : LPCWSTR -> "wstr" ; pwszServerUrl : LPCWSTR -> "wstr" ; pwszClientToken : LPCWSTR optional -> "wstr" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT SLAcquireGenuineTicket(void** ppTicketBlob, DWORD* pcbTicketBlob, LPCWSTR pwszTemplateId, LPCWSTR pwszServerUrl, LPCWSTR pwszClientToken) #uselib "slcext.dll" #cfunc global SLAcquireGenuineTicket "SLAcquireGenuineTicket" intptr, intptr, wstr, wstr, wstr ; res = SLAcquireGenuineTicket(ppTicketBlob, varptr(pcbTicketBlob), pwszTemplateId, pwszServerUrl, pwszClientToken) ; ppTicketBlob : void** out -> "intptr" ; pcbTicketBlob : DWORD* out -> "intptr" ; pwszTemplateId : LPCWSTR -> "wstr" ; pwszServerUrl : LPCWSTR -> "wstr" ; pwszClientToken : LPCWSTR optional -> "wstr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
slcext = windows.NewLazySystemDLL("slcext.dll")
procSLAcquireGenuineTicket = slcext.NewProc("SLAcquireGenuineTicket")
)
// ppTicketBlob (void** out), pcbTicketBlob (DWORD* out), pwszTemplateId (LPCWSTR), pwszServerUrl (LPCWSTR), pwszClientToken (LPCWSTR optional)
r1, _, err := procSLAcquireGenuineTicket.Call(
uintptr(ppTicketBlob),
uintptr(pcbTicketBlob),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwszTemplateId))),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwszServerUrl))),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwszClientToken))),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction SLAcquireGenuineTicket(
ppTicketBlob: Pointer; // void** out
pcbTicketBlob: Pointer; // DWORD* out
pwszTemplateId: PWideChar; // LPCWSTR
pwszServerUrl: PWideChar; // LPCWSTR
pwszClientToken: PWideChar // LPCWSTR optional
): Integer; stdcall;
external 'slcext.dll' name 'SLAcquireGenuineTicket';result := DllCall("slcext\SLAcquireGenuineTicket"
, "Ptr", ppTicketBlob ; void** out
, "Ptr", pcbTicketBlob ; DWORD* out
, "WStr", pwszTemplateId ; LPCWSTR
, "WStr", pwszServerUrl ; LPCWSTR
, "WStr", pwszClientToken ; LPCWSTR optional
, "Int") ; return: HRESULT●SLAcquireGenuineTicket(ppTicketBlob, pcbTicketBlob, pwszTemplateId, pwszServerUrl, pwszClientToken) = DLL("slcext.dll", "int SLAcquireGenuineTicket(void*, void*, char*, char*, char*)")
# 呼び出し: SLAcquireGenuineTicket(ppTicketBlob, pcbTicketBlob, pwszTemplateId, pwszServerUrl, pwszClientToken)
# ppTicketBlob : void** out -> "void*"
# pcbTicketBlob : DWORD* out -> "void*"
# pwszTemplateId : LPCWSTR -> "char*"
# pwszServerUrl : LPCWSTR -> "char*"
# pwszClientToken : LPCWSTR optional -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。