ホーム › Networking.ActiveDirectory › DsCrackSpn3W

DsCrackSpn3W

関数

SPNをホスト名やドメイン名などへ分解する(Unicode版)。

DLLDSPARSE.dll呼出規約winapi

シグネチャ

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

DWORD DsCrackSpn3W(
    LPCWSTR pszSpn,
    DWORD cSpn,
    DWORD* pcHostName,
    LPWSTR HostName,
    DWORD* pcInstanceName,
    LPWSTR InstanceName,
    WORD* pPortNumber,
    DWORD* pcDomainName,
    LPWSTR DomainName,
    DWORD* pcRealmName,
    LPWSTR RealmName
);

パラメーター

名前	型	方向
pszSpn	LPCWSTR	in
cSpn	DWORD	in
pcHostName	DWORD*	inout
HostName	LPWSTR	out
pcInstanceName	DWORD*	inout
InstanceName	LPWSTR	out
pPortNumber	WORD*	inout
pcDomainName	DWORD*	inout
DomainName	LPWSTR	out
pcRealmName	DWORD*	inout
RealmName	LPWSTR	out

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD DsCrackSpn3W(
    LPCWSTR pszSpn,
    DWORD cSpn,
    DWORD* pcHostName,
    LPWSTR HostName,
    DWORD* pcInstanceName,
    LPWSTR InstanceName,
    WORD* pPortNumber,
    DWORD* pcDomainName,
    LPWSTR DomainName,
    DWORD* pcRealmName,
    LPWSTR RealmName
);

[DllImport("DSPARSE.dll", ExactSpelling = true)]
static extern uint DsCrackSpn3W(
    [MarshalAs(UnmanagedType.LPWStr)] string pszSpn,   // LPCWSTR
    uint cSpn,   // DWORD
    ref uint pcHostName,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder HostName,   // LPWSTR out
    ref uint pcInstanceName,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder InstanceName,   // LPWSTR out
    ref ushort pPortNumber,   // WORD* in/out
    ref uint pcDomainName,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder DomainName,   // LPWSTR out
    ref uint pcRealmName,   // DWORD* in/out
    [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder RealmName   // LPWSTR out
);

<DllImport("DSPARSE.dll", ExactSpelling:=True)>
Public Shared Function DsCrackSpn3W(
    <MarshalAs(UnmanagedType.LPWStr)> pszSpn As String,   ' LPCWSTR
    cSpn As UInteger,   ' DWORD
    ByRef pcHostName As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> HostName As System.Text.StringBuilder,   ' LPWSTR out
    ByRef pcInstanceName As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> InstanceName As System.Text.StringBuilder,   ' LPWSTR out
    ByRef pPortNumber As UShort,   ' WORD* in/out
    ByRef pcDomainName As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> DomainName As System.Text.StringBuilder,   ' LPWSTR out
    ByRef pcRealmName As UInteger,   ' DWORD* in/out
    <MarshalAs(UnmanagedType.LPWStr)> RealmName As System.Text.StringBuilder   ' LPWSTR out
) As UInteger
End Function

' pszSpn : LPCWSTR
' cSpn : DWORD
' pcHostName : DWORD* in/out
' HostName : LPWSTR out
' pcInstanceName : DWORD* in/out
' InstanceName : LPWSTR out
' pPortNumber : WORD* in/out
' pcDomainName : DWORD* in/out
' DomainName : LPWSTR out
' pcRealmName : DWORD* in/out
' RealmName : LPWSTR out
Declare PtrSafe Function DsCrackSpn3W Lib "dsparse" ( _
    ByVal pszSpn As LongPtr, _
    ByVal cSpn As Long, _
    ByRef pcHostName As Long, _
    ByVal HostName As LongPtr, _
    ByRef pcInstanceName As Long, _
    ByVal InstanceName As LongPtr, _
    ByRef pPortNumber As Integer, _
    ByRef pcDomainName As Long, _
    ByVal DomainName As LongPtr, _
    ByRef pcRealmName As Long, _
    ByVal RealmName As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DsCrackSpn3W = ctypes.windll.dsparse.DsCrackSpn3W
DsCrackSpn3W.restype = wintypes.DWORD
DsCrackSpn3W.argtypes = [
    wintypes.LPCWSTR,  # pszSpn : LPCWSTR
    wintypes.DWORD,  # cSpn : DWORD
    ctypes.POINTER(wintypes.DWORD),  # pcHostName : DWORD* in/out
    wintypes.LPWSTR,  # HostName : LPWSTR out
    ctypes.POINTER(wintypes.DWORD),  # pcInstanceName : DWORD* in/out
    wintypes.LPWSTR,  # InstanceName : LPWSTR out
    ctypes.POINTER(ctypes.c_ushort),  # pPortNumber : WORD* in/out
    ctypes.POINTER(wintypes.DWORD),  # pcDomainName : DWORD* in/out
    wintypes.LPWSTR,  # DomainName : LPWSTR out
    ctypes.POINTER(wintypes.DWORD),  # pcRealmName : DWORD* in/out
    wintypes.LPWSTR,  # RealmName : LPWSTR out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('DSPARSE.dll')
DsCrackSpn3W = Fiddle::Function.new(
  lib['DsCrackSpn3W'],
  [
    Fiddle::TYPE_VOIDP,  # pszSpn : LPCWSTR
    -Fiddle::TYPE_INT,  # cSpn : DWORD
    Fiddle::TYPE_VOIDP,  # pcHostName : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # HostName : LPWSTR out
    Fiddle::TYPE_VOIDP,  # pcInstanceName : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # InstanceName : LPWSTR out
    Fiddle::TYPE_VOIDP,  # pPortNumber : WORD* in/out
    Fiddle::TYPE_VOIDP,  # pcDomainName : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # DomainName : LPWSTR out
    Fiddle::TYPE_VOIDP,  # pcRealmName : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # RealmName : LPWSTR out
  ],
  -Fiddle::TYPE_INT)

#[link(name = "dsparse")]
extern "system" {
    fn DsCrackSpn3W(
        pszSpn: *const u16,  // LPCWSTR
        cSpn: u32,  // DWORD
        pcHostName: *mut u32,  // DWORD* in/out
        HostName: *mut u16,  // LPWSTR out
        pcInstanceName: *mut u32,  // DWORD* in/out
        InstanceName: *mut u16,  // LPWSTR out
        pPortNumber: *mut u16,  // WORD* in/out
        pcDomainName: *mut u32,  // DWORD* in/out
        DomainName: *mut u16,  // LPWSTR out
        pcRealmName: *mut u32,  // DWORD* in/out
        RealmName: *mut u16  // LPWSTR out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("DSPARSE.dll")]
public static extern uint DsCrackSpn3W([MarshalAs(UnmanagedType.LPWStr)] string pszSpn, uint cSpn, ref uint pcHostName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder HostName, ref uint pcInstanceName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder InstanceName, ref ushort pPortNumber, ref uint pcDomainName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder DomainName, ref uint pcRealmName, [MarshalAs(UnmanagedType.LPWStr)] System.Text.StringBuilder RealmName);
"@
$api = Add-Type -MemberDefinition $sig -Name 'DSPARSE_DsCrackSpn3W' -Namespace Win32 -PassThru
# $api::DsCrackSpn3W(pszSpn, cSpn, pcHostName, HostName, pcInstanceName, InstanceName, pPortNumber, pcDomainName, DomainName, pcRealmName, RealmName)

#uselib "DSPARSE.dll"
#func global DsCrackSpn3W "DsCrackSpn3W" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DsCrackSpn3W pszSpn, cSpn, varptr(pcHostName), varptr(HostName), varptr(pcInstanceName), varptr(InstanceName), varptr(pPortNumber), varptr(pcDomainName), varptr(DomainName), varptr(pcRealmName), varptr(RealmName)   ; 戻り値は stat
; pszSpn : LPCWSTR -> "sptr"
; cSpn : DWORD -> "sptr"
; pcHostName : DWORD* in/out -> "sptr"
; HostName : LPWSTR out -> "sptr"
; pcInstanceName : DWORD* in/out -> "sptr"
; InstanceName : LPWSTR out -> "sptr"
; pPortNumber : WORD* in/out -> "sptr"
; pcDomainName : DWORD* in/out -> "sptr"
; DomainName : LPWSTR out -> "sptr"
; pcRealmName : DWORD* in/out -> "sptr"
; RealmName : LPWSTR out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "DSPARSE.dll"
#cfunc global DsCrackSpn3W "DsCrackSpn3W" wstr, int, var, var, var, var, var, var, var, var, var
; res = DsCrackSpn3W(pszSpn, cSpn, pcHostName, HostName, pcInstanceName, InstanceName, pPortNumber, pcDomainName, DomainName, pcRealmName, RealmName)
; pszSpn : LPCWSTR -> "wstr"
; cSpn : DWORD -> "int"
; pcHostName : DWORD* in/out -> "var"
; HostName : LPWSTR out -> "var"
; pcInstanceName : DWORD* in/out -> "var"
; InstanceName : LPWSTR out -> "var"
; pPortNumber : WORD* in/out -> "var"
; pcDomainName : DWORD* in/out -> "var"
; DomainName : LPWSTR out -> "var"
; pcRealmName : DWORD* in/out -> "var"
; RealmName : LPWSTR out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "DSPARSE.dll"
#cfunc global DsCrackSpn3W "DsCrackSpn3W" wstr, int, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; res = DsCrackSpn3W(pszSpn, cSpn, varptr(pcHostName), varptr(HostName), varptr(pcInstanceName), varptr(InstanceName), varptr(pPortNumber), varptr(pcDomainName), varptr(DomainName), varptr(pcRealmName), varptr(RealmName))
; pszSpn : LPCWSTR -> "wstr"
; cSpn : DWORD -> "int"
; pcHostName : DWORD* in/out -> "sptr"
; HostName : LPWSTR out -> "sptr"
; pcInstanceName : DWORD* in/out -> "sptr"
; InstanceName : LPWSTR out -> "sptr"
; pPortNumber : WORD* in/out -> "sptr"
; pcDomainName : DWORD* in/out -> "sptr"
; DomainName : LPWSTR out -> "sptr"
; pcRealmName : DWORD* in/out -> "sptr"
; RealmName : LPWSTR out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; DWORD DsCrackSpn3W(LPCWSTR pszSpn, DWORD cSpn, DWORD* pcHostName, LPWSTR HostName, DWORD* pcInstanceName, LPWSTR InstanceName, WORD* pPortNumber, DWORD* pcDomainName, LPWSTR DomainName, DWORD* pcRealmName, LPWSTR RealmName)
#uselib "DSPARSE.dll"
#cfunc global DsCrackSpn3W "DsCrackSpn3W" wstr, int, var, var, var, var, var, var, var, var, var
; res = DsCrackSpn3W(pszSpn, cSpn, pcHostName, HostName, pcInstanceName, InstanceName, pPortNumber, pcDomainName, DomainName, pcRealmName, RealmName)
; pszSpn : LPCWSTR -> "wstr"
; cSpn : DWORD -> "int"
; pcHostName : DWORD* in/out -> "var"
; HostName : LPWSTR out -> "var"
; pcInstanceName : DWORD* in/out -> "var"
; InstanceName : LPWSTR out -> "var"
; pPortNumber : WORD* in/out -> "var"
; pcDomainName : DWORD* in/out -> "var"
; DomainName : LPWSTR out -> "var"
; pcRealmName : DWORD* in/out -> "var"
; RealmName : LPWSTR out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD DsCrackSpn3W(LPCWSTR pszSpn, DWORD cSpn, DWORD* pcHostName, LPWSTR HostName, DWORD* pcInstanceName, LPWSTR InstanceName, WORD* pPortNumber, DWORD* pcDomainName, LPWSTR DomainName, DWORD* pcRealmName, LPWSTR RealmName)
#uselib "DSPARSE.dll"
#cfunc global DsCrackSpn3W "DsCrackSpn3W" wstr, int, intptr, intptr, intptr, intptr, intptr, intptr, intptr, intptr, intptr
; res = DsCrackSpn3W(pszSpn, cSpn, varptr(pcHostName), varptr(HostName), varptr(pcInstanceName), varptr(InstanceName), varptr(pPortNumber), varptr(pcDomainName), varptr(DomainName), varptr(pcRealmName), varptr(RealmName))
; pszSpn : LPCWSTR -> "wstr"
; cSpn : DWORD -> "int"
; pcHostName : DWORD* in/out -> "intptr"
; HostName : LPWSTR out -> "intptr"
; pcInstanceName : DWORD* in/out -> "intptr"
; InstanceName : LPWSTR out -> "intptr"
; pPortNumber : WORD* in/out -> "intptr"
; pcDomainName : DWORD* in/out -> "intptr"
; DomainName : LPWSTR out -> "intptr"
; pcRealmName : DWORD* in/out -> "intptr"
; RealmName : LPWSTR out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	dsparse = windows.NewLazySystemDLL("DSPARSE.dll")
	procDsCrackSpn3W = dsparse.NewProc("DsCrackSpn3W")
)

// pszSpn (LPCWSTR), cSpn (DWORD), pcHostName (DWORD* in/out), HostName (LPWSTR out), pcInstanceName (DWORD* in/out), InstanceName (LPWSTR out), pPortNumber (WORD* in/out), pcDomainName (DWORD* in/out), DomainName (LPWSTR out), pcRealmName (DWORD* in/out), RealmName (LPWSTR out)
r1, _, err := procDsCrackSpn3W.Call(
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszSpn))),
	uintptr(cSpn),
	uintptr(pcHostName),
	uintptr(HostName),
	uintptr(pcInstanceName),
	uintptr(InstanceName),
	uintptr(pPortNumber),
	uintptr(pcDomainName),
	uintptr(DomainName),
	uintptr(pcRealmName),
	uintptr(RealmName),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function DsCrackSpn3W(
  pszSpn: PWideChar;   // LPCWSTR
  cSpn: DWORD;   // DWORD
  pcHostName: Pointer;   // DWORD* in/out
  HostName: PWideChar;   // LPWSTR out
  pcInstanceName: Pointer;   // DWORD* in/out
  InstanceName: PWideChar;   // LPWSTR out
  pPortNumber: Pointer;   // WORD* in/out
  pcDomainName: Pointer;   // DWORD* in/out
  DomainName: PWideChar;   // LPWSTR out
  pcRealmName: Pointer;   // DWORD* in/out
  RealmName: PWideChar   // LPWSTR out
): DWORD; stdcall;
  external 'DSPARSE.dll' name 'DsCrackSpn3W';

result := DllCall("DSPARSE\DsCrackSpn3W"
    , "WStr", pszSpn   ; LPCWSTR
    , "UInt", cSpn   ; DWORD
    , "Ptr", pcHostName   ; DWORD* in/out
    , "Ptr", HostName   ; LPWSTR out
    , "Ptr", pcInstanceName   ; DWORD* in/out
    , "Ptr", InstanceName   ; LPWSTR out
    , "Ptr", pPortNumber   ; WORD* in/out
    , "Ptr", pcDomainName   ; DWORD* in/out
    , "Ptr", DomainName   ; LPWSTR out
    , "Ptr", pcRealmName   ; DWORD* in/out
    , "Ptr", RealmName   ; LPWSTR out
    , "UInt")   ; return: DWORD

●DsCrackSpn3W(pszSpn, cSpn, pcHostName, HostName, pcInstanceName, InstanceName, pPortNumber, pcDomainName, DomainName, pcRealmName, RealmName) = DLL("DSPARSE.dll", "dword DsCrackSpn3W(char*, dword, void*, char*, void*, char*, void*, void*, char*, void*, char*)")
# 呼び出し: DsCrackSpn3W(pszSpn, cSpn, pcHostName, HostName, pcInstanceName, InstanceName, pPortNumber, pcDomainName, DomainName, pcRealmName, RealmName)
# pszSpn : LPCWSTR -> "char*"
# cSpn : DWORD -> "dword"
# pcHostName : DWORD* in/out -> "void*"
# HostName : LPWSTR out -> "char*"
# pcInstanceName : DWORD* in/out -> "void*"
# InstanceName : LPWSTR out -> "char*"
# pPortNumber : WORD* in/out -> "void*"
# pcDomainName : DWORD* in/out -> "void*"
# DomainName : LPWSTR out -> "char*"
# pcRealmName : DWORD* in/out -> "void*"
# RealmName : LPWSTR out -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。