ホーム › Networking.WindowsWebServices › WsCreateServiceEndpointFromTemplate

WsCreateServiceEndpointFromTemplate

関数

バインディングテンプレートからサービスエンドポイントを作成する。

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

シグネチャ

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

HRESULT WsCreateServiceEndpointFromTemplate(
    WS_CHANNEL_TYPE channelType,
    const WS_SERVICE_ENDPOINT_PROPERTY* properties,   // optional
    DWORD propertyCount,
    const WS_STRING* addressUrl,   // optional
    const WS_SERVICE_CONTRACT* contract,
    WS_SERVICE_SECURITY_CALLBACK authorizationCallback,   // optional
    WS_HEAP* heap,
    WS_BINDING_TEMPLATE_TYPE templateType,
    void* templateValue,   // optional
    DWORD templateSize,
    const void* templateDescription,
    DWORD templateDescriptionSize,
    WS_SERVICE_ENDPOINT** serviceEndpoint,
    WS_ERROR* error   // optional
);

パラメーター

名前	型	方向
channelType	WS_CHANNEL_TYPE	in
properties	WS_SERVICE_ENDPOINT_PROPERTY*	inoptional
propertyCount	DWORD	in
addressUrl	WS_STRING*	inoptional
contract	WS_SERVICE_CONTRACT*	in
authorizationCallback	WS_SERVICE_SECURITY_CALLBACK	inoptional
heap	WS_HEAP*	in
templateType	WS_BINDING_TEMPLATE_TYPE	in
templateValue	void*	inoptional
templateSize	DWORD	in
templateDescription	void*	in
templateDescriptionSize	DWORD	in
serviceEndpoint	WS_SERVICE_ENDPOINT**	out
error	WS_ERROR*	inoptional

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT WsCreateServiceEndpointFromTemplate(
    WS_CHANNEL_TYPE channelType,
    const WS_SERVICE_ENDPOINT_PROPERTY* properties,   // optional
    DWORD propertyCount,
    const WS_STRING* addressUrl,   // optional
    const WS_SERVICE_CONTRACT* contract,
    WS_SERVICE_SECURITY_CALLBACK authorizationCallback,   // optional
    WS_HEAP* heap,
    WS_BINDING_TEMPLATE_TYPE templateType,
    void* templateValue,   // optional
    DWORD templateSize,
    const void* templateDescription,
    DWORD templateDescriptionSize,
    WS_SERVICE_ENDPOINT** serviceEndpoint,
    WS_ERROR* error   // optional
);

[DllImport("webservices.dll", ExactSpelling = true)]
static extern int WsCreateServiceEndpointFromTemplate(
    int channelType,   // WS_CHANNEL_TYPE
    IntPtr properties,   // WS_SERVICE_ENDPOINT_PROPERTY* optional
    uint propertyCount,   // DWORD
    IntPtr addressUrl,   // WS_STRING* optional
    IntPtr contract,   // WS_SERVICE_CONTRACT*
    IntPtr authorizationCallback,   // WS_SERVICE_SECURITY_CALLBACK optional
    ref IntPtr heap,   // WS_HEAP*
    int templateType,   // WS_BINDING_TEMPLATE_TYPE
    IntPtr templateValue,   // void* optional
    uint templateSize,   // DWORD
    IntPtr templateDescription,   // void*
    uint templateDescriptionSize,   // DWORD
    IntPtr serviceEndpoint,   // WS_SERVICE_ENDPOINT** out
    IntPtr error   // WS_ERROR* optional
);

<DllImport("webservices.dll", ExactSpelling:=True)>
Public Shared Function WsCreateServiceEndpointFromTemplate(
    channelType As Integer,   ' WS_CHANNEL_TYPE
    properties As IntPtr,   ' WS_SERVICE_ENDPOINT_PROPERTY* optional
    propertyCount As UInteger,   ' DWORD
    addressUrl As IntPtr,   ' WS_STRING* optional
    contract As IntPtr,   ' WS_SERVICE_CONTRACT*
    authorizationCallback As IntPtr,   ' WS_SERVICE_SECURITY_CALLBACK optional
    ByRef heap As IntPtr,   ' WS_HEAP*
    templateType As Integer,   ' WS_BINDING_TEMPLATE_TYPE
    templateValue As IntPtr,   ' void* optional
    templateSize As UInteger,   ' DWORD
    templateDescription As IntPtr,   ' void*
    templateDescriptionSize As UInteger,   ' DWORD
    serviceEndpoint As IntPtr,   ' WS_SERVICE_ENDPOINT** out
    [error] As IntPtr   ' WS_ERROR* optional
) As Integer
End Function

' channelType : WS_CHANNEL_TYPE
' properties : WS_SERVICE_ENDPOINT_PROPERTY* optional
' propertyCount : DWORD
' addressUrl : WS_STRING* optional
' contract : WS_SERVICE_CONTRACT*
' authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional
' heap : WS_HEAP*
' templateType : WS_BINDING_TEMPLATE_TYPE
' templateValue : void* optional
' templateSize : DWORD
' templateDescription : void*
' templateDescriptionSize : DWORD
' serviceEndpoint : WS_SERVICE_ENDPOINT** out
' error : WS_ERROR* optional
Declare PtrSafe Function WsCreateServiceEndpointFromTemplate Lib "webservices" ( _
    ByVal channelType As Long, _
    ByVal properties As LongPtr, _
    ByVal propertyCount As Long, _
    ByVal addressUrl As LongPtr, _
    ByVal contract As LongPtr, _
    ByVal authorizationCallback As LongPtr, _
    ByRef heap As LongPtr, _
    ByVal templateType As Long, _
    ByVal templateValue As LongPtr, _
    ByVal templateSize As Long, _
    ByVal templateDescription As LongPtr, _
    ByVal templateDescriptionSize As Long, _
    ByVal serviceEndpoint As LongPtr, _
    ByVal error As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WsCreateServiceEndpointFromTemplate = ctypes.windll.webservices.WsCreateServiceEndpointFromTemplate
WsCreateServiceEndpointFromTemplate.restype = ctypes.c_int
WsCreateServiceEndpointFromTemplate.argtypes = [
    ctypes.c_int,  # channelType : WS_CHANNEL_TYPE
    ctypes.c_void_p,  # properties : WS_SERVICE_ENDPOINT_PROPERTY* optional
    wintypes.DWORD,  # propertyCount : DWORD
    ctypes.c_void_p,  # addressUrl : WS_STRING* optional
    ctypes.c_void_p,  # contract : WS_SERVICE_CONTRACT*
    ctypes.c_void_p,  # authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional
    ctypes.c_void_p,  # heap : WS_HEAP*
    ctypes.c_int,  # templateType : WS_BINDING_TEMPLATE_TYPE
    ctypes.POINTER(None),  # templateValue : void* optional
    wintypes.DWORD,  # templateSize : DWORD
    ctypes.POINTER(None),  # templateDescription : void*
    wintypes.DWORD,  # templateDescriptionSize : DWORD
    ctypes.c_void_p,  # serviceEndpoint : WS_SERVICE_ENDPOINT** out
    ctypes.c_void_p,  # error : WS_ERROR* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('webservices.dll')
WsCreateServiceEndpointFromTemplate = Fiddle::Function.new(
  lib['WsCreateServiceEndpointFromTemplate'],
  [
    Fiddle::TYPE_INT,  # channelType : WS_CHANNEL_TYPE
    Fiddle::TYPE_VOIDP,  # properties : WS_SERVICE_ENDPOINT_PROPERTY* optional
    -Fiddle::TYPE_INT,  # propertyCount : DWORD
    Fiddle::TYPE_VOIDP,  # addressUrl : WS_STRING* optional
    Fiddle::TYPE_VOIDP,  # contract : WS_SERVICE_CONTRACT*
    Fiddle::TYPE_VOIDP,  # authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional
    Fiddle::TYPE_VOIDP,  # heap : WS_HEAP*
    Fiddle::TYPE_INT,  # templateType : WS_BINDING_TEMPLATE_TYPE
    Fiddle::TYPE_VOIDP,  # templateValue : void* optional
    -Fiddle::TYPE_INT,  # templateSize : DWORD
    Fiddle::TYPE_VOIDP,  # templateDescription : void*
    -Fiddle::TYPE_INT,  # templateDescriptionSize : DWORD
    Fiddle::TYPE_VOIDP,  # serviceEndpoint : WS_SERVICE_ENDPOINT** out
    Fiddle::TYPE_VOIDP,  # error : WS_ERROR* optional
  ],
  Fiddle::TYPE_INT)

#[link(name = "webservices")]
extern "system" {
    fn WsCreateServiceEndpointFromTemplate(
        channelType: i32,  // WS_CHANNEL_TYPE
        properties: *const WS_SERVICE_ENDPOINT_PROPERTY,  // WS_SERVICE_ENDPOINT_PROPERTY* optional
        propertyCount: u32,  // DWORD
        addressUrl: *const WS_STRING,  // WS_STRING* optional
        contract: *const WS_SERVICE_CONTRACT,  // WS_SERVICE_CONTRACT*
        authorizationCallback: *const core::ffi::c_void,  // WS_SERVICE_SECURITY_CALLBACK optional
        heap: *mut isize,  // WS_HEAP*
        templateType: i32,  // WS_BINDING_TEMPLATE_TYPE
        templateValue: *mut (),  // void* optional
        templateSize: u32,  // DWORD
        templateDescription: *const (),  // void*
        templateDescriptionSize: u32,  // DWORD
        serviceEndpoint: *mut *mut WS_SERVICE_ENDPOINT,  // WS_SERVICE_ENDPOINT** out
        error: *mut isize  // WS_ERROR* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("webservices.dll")]
public static extern int WsCreateServiceEndpointFromTemplate(int channelType, IntPtr properties, uint propertyCount, IntPtr addressUrl, IntPtr contract, IntPtr authorizationCallback, ref IntPtr heap, int templateType, IntPtr templateValue, uint templateSize, IntPtr templateDescription, uint templateDescriptionSize, IntPtr serviceEndpoint, IntPtr error);
"@
$api = Add-Type -MemberDefinition $sig -Name 'webservices_WsCreateServiceEndpointFromTemplate' -Namespace Win32 -PassThru
# $api::WsCreateServiceEndpointFromTemplate(channelType, properties, propertyCount, addressUrl, contract, authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, serviceEndpoint, error)

#uselib "webservices.dll"
#func global WsCreateServiceEndpointFromTemplate "WsCreateServiceEndpointFromTemplate" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WsCreateServiceEndpointFromTemplate channelType, varptr(properties), propertyCount, varptr(addressUrl), varptr(contract), authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, varptr(serviceEndpoint), error   ; 戻り値は stat
; channelType : WS_CHANNEL_TYPE -> "sptr"
; properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "sptr"
; propertyCount : DWORD -> "sptr"
; addressUrl : WS_STRING* optional -> "sptr"
; contract : WS_SERVICE_CONTRACT* -> "sptr"
; authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "sptr"
; heap : WS_HEAP* -> "sptr"
; templateType : WS_BINDING_TEMPLATE_TYPE -> "sptr"
; templateValue : void* optional -> "sptr"
; templateSize : DWORD -> "sptr"
; templateDescription : void* -> "sptr"
; templateDescriptionSize : DWORD -> "sptr"
; serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "sptr"
; error : WS_ERROR* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "webservices.dll"
#cfunc global WsCreateServiceEndpointFromTemplate "WsCreateServiceEndpointFromTemplate" int, var, int, var, var, sptr, int, int, sptr, int, sptr, int, var, int
; res = WsCreateServiceEndpointFromTemplate(channelType, properties, propertyCount, addressUrl, contract, authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, serviceEndpoint, error)
; channelType : WS_CHANNEL_TYPE -> "int"
; properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "var"
; propertyCount : DWORD -> "int"
; addressUrl : WS_STRING* optional -> "var"
; contract : WS_SERVICE_CONTRACT* -> "var"
; authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "sptr"
; heap : WS_HEAP* -> "int"
; templateType : WS_BINDING_TEMPLATE_TYPE -> "int"
; templateValue : void* optional -> "sptr"
; templateSize : DWORD -> "int"
; templateDescription : void* -> "sptr"
; templateDescriptionSize : DWORD -> "int"
; serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "var"
; error : WS_ERROR* optional -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "webservices.dll"
#cfunc global WsCreateServiceEndpointFromTemplate "WsCreateServiceEndpointFromTemplate" int, sptr, int, sptr, sptr, sptr, int, int, sptr, int, sptr, int, sptr, int
; res = WsCreateServiceEndpointFromTemplate(channelType, varptr(properties), propertyCount, varptr(addressUrl), varptr(contract), authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, varptr(serviceEndpoint), error)
; channelType : WS_CHANNEL_TYPE -> "int"
; properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "sptr"
; propertyCount : DWORD -> "int"
; addressUrl : WS_STRING* optional -> "sptr"
; contract : WS_SERVICE_CONTRACT* -> "sptr"
; authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "sptr"
; heap : WS_HEAP* -> "int"
; templateType : WS_BINDING_TEMPLATE_TYPE -> "int"
; templateValue : void* optional -> "sptr"
; templateSize : DWORD -> "int"
; templateDescription : void* -> "sptr"
; templateDescriptionSize : DWORD -> "int"
; serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "sptr"
; error : WS_ERROR* optional -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT WsCreateServiceEndpointFromTemplate(WS_CHANNEL_TYPE channelType, WS_SERVICE_ENDPOINT_PROPERTY* properties, DWORD propertyCount, WS_STRING* addressUrl, WS_SERVICE_CONTRACT* contract, WS_SERVICE_SECURITY_CALLBACK authorizationCallback, WS_HEAP* heap, WS_BINDING_TEMPLATE_TYPE templateType, void* templateValue, DWORD templateSize, void* templateDescription, DWORD templateDescriptionSize, WS_SERVICE_ENDPOINT** serviceEndpoint, WS_ERROR* error)
#uselib "webservices.dll"
#cfunc global WsCreateServiceEndpointFromTemplate "WsCreateServiceEndpointFromTemplate" int, var, int, var, var, intptr, int, int, intptr, int, intptr, int, var, int
; res = WsCreateServiceEndpointFromTemplate(channelType, properties, propertyCount, addressUrl, contract, authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, serviceEndpoint, error)
; channelType : WS_CHANNEL_TYPE -> "int"
; properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "var"
; propertyCount : DWORD -> "int"
; addressUrl : WS_STRING* optional -> "var"
; contract : WS_SERVICE_CONTRACT* -> "var"
; authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "intptr"
; heap : WS_HEAP* -> "int"
; templateType : WS_BINDING_TEMPLATE_TYPE -> "int"
; templateValue : void* optional -> "intptr"
; templateSize : DWORD -> "int"
; templateDescription : void* -> "intptr"
; templateDescriptionSize : DWORD -> "int"
; serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "var"
; error : WS_ERROR* optional -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT WsCreateServiceEndpointFromTemplate(WS_CHANNEL_TYPE channelType, WS_SERVICE_ENDPOINT_PROPERTY* properties, DWORD propertyCount, WS_STRING* addressUrl, WS_SERVICE_CONTRACT* contract, WS_SERVICE_SECURITY_CALLBACK authorizationCallback, WS_HEAP* heap, WS_BINDING_TEMPLATE_TYPE templateType, void* templateValue, DWORD templateSize, void* templateDescription, DWORD templateDescriptionSize, WS_SERVICE_ENDPOINT** serviceEndpoint, WS_ERROR* error)
#uselib "webservices.dll"
#cfunc global WsCreateServiceEndpointFromTemplate "WsCreateServiceEndpointFromTemplate" int, intptr, int, intptr, intptr, intptr, int, int, intptr, int, intptr, int, intptr, int
; res = WsCreateServiceEndpointFromTemplate(channelType, varptr(properties), propertyCount, varptr(addressUrl), varptr(contract), authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, varptr(serviceEndpoint), error)
; channelType : WS_CHANNEL_TYPE -> "int"
; properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "intptr"
; propertyCount : DWORD -> "int"
; addressUrl : WS_STRING* optional -> "intptr"
; contract : WS_SERVICE_CONTRACT* -> "intptr"
; authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "intptr"
; heap : WS_HEAP* -> "int"
; templateType : WS_BINDING_TEMPLATE_TYPE -> "int"
; templateValue : void* optional -> "intptr"
; templateSize : DWORD -> "int"
; templateDescription : void* -> "intptr"
; templateDescriptionSize : DWORD -> "int"
; serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "intptr"
; error : WS_ERROR* optional -> "int"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	webservices = windows.NewLazySystemDLL("webservices.dll")
	procWsCreateServiceEndpointFromTemplate = webservices.NewProc("WsCreateServiceEndpointFromTemplate")
)

// channelType (WS_CHANNEL_TYPE), properties (WS_SERVICE_ENDPOINT_PROPERTY* optional), propertyCount (DWORD), addressUrl (WS_STRING* optional), contract (WS_SERVICE_CONTRACT*), authorizationCallback (WS_SERVICE_SECURITY_CALLBACK optional), heap (WS_HEAP*), templateType (WS_BINDING_TEMPLATE_TYPE), templateValue (void* optional), templateSize (DWORD), templateDescription (void*), templateDescriptionSize (DWORD), serviceEndpoint (WS_SERVICE_ENDPOINT** out), error (WS_ERROR* optional)
r1, _, err := procWsCreateServiceEndpointFromTemplate.Call(
	uintptr(channelType),
	uintptr(properties),
	uintptr(propertyCount),
	uintptr(addressUrl),
	uintptr(contract),
	uintptr(authorizationCallback),
	uintptr(heap),
	uintptr(templateType),
	uintptr(templateValue),
	uintptr(templateSize),
	uintptr(templateDescription),
	uintptr(templateDescriptionSize),
	uintptr(serviceEndpoint),
	uintptr(error),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function WsCreateServiceEndpointFromTemplate(
  channelType: Integer;   // WS_CHANNEL_TYPE
  properties: Pointer;   // WS_SERVICE_ENDPOINT_PROPERTY* optional
  propertyCount: DWORD;   // DWORD
  addressUrl: Pointer;   // WS_STRING* optional
  contract: Pointer;   // WS_SERVICE_CONTRACT*
  authorizationCallback: Pointer;   // WS_SERVICE_SECURITY_CALLBACK optional
  heap: Pointer;   // WS_HEAP*
  templateType: Integer;   // WS_BINDING_TEMPLATE_TYPE
  templateValue: Pointer;   // void* optional
  templateSize: DWORD;   // DWORD
  templateDescription: Pointer;   // void*
  templateDescriptionSize: DWORD;   // DWORD
  serviceEndpoint: Pointer;   // WS_SERVICE_ENDPOINT** out
  error: Pointer   // WS_ERROR* optional
): Integer; stdcall;
  external 'webservices.dll' name 'WsCreateServiceEndpointFromTemplate';

result := DllCall("webservices\WsCreateServiceEndpointFromTemplate"
    , "Int", channelType   ; WS_CHANNEL_TYPE
    , "Ptr", properties   ; WS_SERVICE_ENDPOINT_PROPERTY* optional
    , "UInt", propertyCount   ; DWORD
    , "Ptr", addressUrl   ; WS_STRING* optional
    , "Ptr", contract   ; WS_SERVICE_CONTRACT*
    , "Ptr", authorizationCallback   ; WS_SERVICE_SECURITY_CALLBACK optional
    , "Ptr", heap   ; WS_HEAP*
    , "Int", templateType   ; WS_BINDING_TEMPLATE_TYPE
    , "Ptr", templateValue   ; void* optional
    , "UInt", templateSize   ; DWORD
    , "Ptr", templateDescription   ; void*
    , "UInt", templateDescriptionSize   ; DWORD
    , "Ptr", serviceEndpoint   ; WS_SERVICE_ENDPOINT** out
    , "Ptr", error   ; WS_ERROR* optional
    , "Int")   ; return: HRESULT

●WsCreateServiceEndpointFromTemplate(channelType, properties, propertyCount, addressUrl, contract, authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, serviceEndpoint, error) = DLL("webservices.dll", "int WsCreateServiceEndpointFromTemplate(int, void*, dword, void*, void*, void*, void*, int, void*, dword, void*, dword, void*, void*)")
# 呼び出し: WsCreateServiceEndpointFromTemplate(channelType, properties, propertyCount, addressUrl, contract, authorizationCallback, heap, templateType, templateValue, templateSize, templateDescription, templateDescriptionSize, serviceEndpoint, error)
# channelType : WS_CHANNEL_TYPE -> "int"
# properties : WS_SERVICE_ENDPOINT_PROPERTY* optional -> "void*"
# propertyCount : DWORD -> "dword"
# addressUrl : WS_STRING* optional -> "void*"
# contract : WS_SERVICE_CONTRACT* -> "void*"
# authorizationCallback : WS_SERVICE_SECURITY_CALLBACK optional -> "void*"
# heap : WS_HEAP* -> "void*"
# templateType : WS_BINDING_TEMPLATE_TYPE -> "int"
# templateValue : void* optional -> "void*"
# templateSize : DWORD -> "dword"
# templateDescription : void* -> "void*"
# templateDescriptionSize : DWORD -> "dword"
# serviceEndpoint : WS_SERVICE_ENDPOINT** out -> "void*"
# error : WS_ERROR* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。