Win32 API 日本語リファレンス
ホームSystem.Js › JsStringToPointer

JsStringToPointer

関数
JavaScript文字列値からワイド文字列ポインタを取得する。
DLLchakra.dll呼出規約winapi

シグネチャ

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

JsErrorCode JsStringToPointer(
    void* value,
    const WORD** stringValue,
    UINT_PTR* stringLength
);

パラメーター

名前方向
valuevoid*in
stringValueWORD**out
stringLengthUINT_PTR*out

戻り値の型: JsErrorCode

各言語での呼び出し定義

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

JsErrorCode JsStringToPointer(
    void* value,
    const WORD** stringValue,
    UINT_PTR* stringLength
);
[DllImport("chakra.dll", ExactSpelling = true)]
static extern uint JsStringToPointer(
    IntPtr value,   // void*
    IntPtr stringValue,   // WORD** out
    out UIntPtr stringLength   // UINT_PTR* out
);
<DllImport("chakra.dll", ExactSpelling:=True)>
Public Shared Function JsStringToPointer(
    value As IntPtr,   ' void*
    stringValue As IntPtr,   ' WORD** out
    <Out> ByRef stringLength As UIntPtr   ' UINT_PTR* out
) As UInteger
End Function
' value : void*
' stringValue : WORD** out
' stringLength : UINT_PTR* out
Declare PtrSafe Function JsStringToPointer Lib "chakra" ( _
    ByVal value As LongPtr, _
    ByVal stringValue As LongPtr, _
    ByRef stringLength As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

JsStringToPointer = ctypes.windll.chakra.JsStringToPointer
JsStringToPointer.restype = wintypes.DWORD
JsStringToPointer.argtypes = [
    ctypes.POINTER(None),  # value : void*
    ctypes.c_void_p,  # stringValue : WORD** out
    ctypes.POINTER(ctypes.c_size_t),  # stringLength : UINT_PTR* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('chakra.dll')
JsStringToPointer = Fiddle::Function.new(
  lib['JsStringToPointer'],
  [
    Fiddle::TYPE_VOIDP,  # value : void*
    Fiddle::TYPE_VOIDP,  # stringValue : WORD** out
    Fiddle::TYPE_VOIDP,  # stringLength : UINT_PTR* out
  ],
  -Fiddle::TYPE_INT)
#[link(name = "chakra")]
extern "system" {
    fn JsStringToPointer(
        value: *mut (),  // void*
        stringValue: *const *const u16,  // WORD** out
        stringLength: *mut usize  // UINT_PTR* out
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("chakra.dll")]
public static extern uint JsStringToPointer(IntPtr value, IntPtr stringValue, out UIntPtr stringLength);
"@
$api = Add-Type -MemberDefinition $sig -Name 'chakra_JsStringToPointer' -Namespace Win32 -PassThru
# $api::JsStringToPointer(value, stringValue, stringLength)
#uselib "chakra.dll"
#func global JsStringToPointer "JsStringToPointer" sptr, sptr, sptr
; JsStringToPointer value, varptr(stringValue), varptr(stringLength)   ; 戻り値は stat
; value : void* -> "sptr"
; stringValue : WORD** out -> "sptr"
; stringLength : UINT_PTR* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "chakra.dll"
#cfunc global JsStringToPointer "JsStringToPointer" sptr, var, var
; res = JsStringToPointer(value, stringValue, stringLength)
; value : void* -> "sptr"
; stringValue : WORD** out -> "var"
; stringLength : UINT_PTR* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; JsErrorCode JsStringToPointer(void* value, WORD** stringValue, UINT_PTR* stringLength)
#uselib "chakra.dll"
#cfunc global JsStringToPointer "JsStringToPointer" intptr, var, var
; res = JsStringToPointer(value, stringValue, stringLength)
; value : void* -> "intptr"
; stringValue : WORD** out -> "var"
; stringLength : UINT_PTR* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	chakra = windows.NewLazySystemDLL("chakra.dll")
	procJsStringToPointer = chakra.NewProc("JsStringToPointer")
)

// value (void*), stringValue (WORD** out), stringLength (UINT_PTR* out)
r1, _, err := procJsStringToPointer.Call(
	uintptr(value),
	uintptr(stringValue),
	uintptr(stringLength),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // JsErrorCode
function JsStringToPointer(
  value: Pointer;   // void*
  stringValue: Pointer;   // WORD** out
  stringLength: Pointer   // UINT_PTR* out
): DWORD; stdcall;
  external 'chakra.dll' name 'JsStringToPointer';
result := DllCall("chakra\JsStringToPointer"
    , "Ptr", value   ; void*
    , "Ptr", stringValue   ; WORD** out
    , "Ptr", stringLength   ; UINT_PTR* out
    , "UInt")   ; return: JsErrorCode
●JsStringToPointer(value, stringValue, stringLength) = DLL("chakra.dll", "dword JsStringToPointer(void*, void*, void*)")
# 呼び出し: JsStringToPointer(value, stringValue, stringLength)
# value : void* -> "void*"
# stringValue : WORD** out -> "void*"
# stringLength : UINT_PTR* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。