ホーム › System.Com.Urlmon › HlinkSimpleNavigateToString
HlinkSimpleNavigateToString
関数URL文字列を指定してハイパーリンクへ簡易ナビゲートする。
シグネチャ
// urlmon.dll
#include <windows.h>
HRESULT HlinkSimpleNavigateToString(
LPCWSTR szTarget, // optional
LPCWSTR szLocation, // optional
LPCWSTR szTargetFrameName, // optional
IUnknown* pUnk,
IBindCtx* pbc, // optional
IBindStatusCallback* param5, // optional
DWORD grfHLNF,
DWORD dwReserved
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| szTarget | LPCWSTR | inoptional |
| szLocation | LPCWSTR | inoptional |
| szTargetFrameName | LPCWSTR | inoptional |
| pUnk | IUnknown* | in |
| pbc | IBindCtx* | inoptional |
| param5 | IBindStatusCallback* | inoptional |
| grfHLNF | DWORD | in |
| dwReserved | DWORD | in |
戻り値の型: HRESULT
各言語での呼び出し定義
// urlmon.dll
#include <windows.h>
HRESULT HlinkSimpleNavigateToString(
LPCWSTR szTarget, // optional
LPCWSTR szLocation, // optional
LPCWSTR szTargetFrameName, // optional
IUnknown* pUnk,
IBindCtx* pbc, // optional
IBindStatusCallback* param5, // optional
DWORD grfHLNF,
DWORD dwReserved
);[DllImport("urlmon.dll", ExactSpelling = true)]
static extern int HlinkSimpleNavigateToString(
[MarshalAs(UnmanagedType.LPWStr)] string szTarget, // LPCWSTR optional
[MarshalAs(UnmanagedType.LPWStr)] string szLocation, // LPCWSTR optional
[MarshalAs(UnmanagedType.LPWStr)] string szTargetFrameName, // LPCWSTR optional
IntPtr pUnk, // IUnknown*
IntPtr pbc, // IBindCtx* optional
IntPtr param5, // IBindStatusCallback* optional
uint grfHLNF, // DWORD
uint dwReserved // DWORD
);<DllImport("urlmon.dll", ExactSpelling:=True)>
Public Shared Function HlinkSimpleNavigateToString(
<MarshalAs(UnmanagedType.LPWStr)> szTarget As String, ' LPCWSTR optional
<MarshalAs(UnmanagedType.LPWStr)> szLocation As String, ' LPCWSTR optional
<MarshalAs(UnmanagedType.LPWStr)> szTargetFrameName As String, ' LPCWSTR optional
pUnk As IntPtr, ' IUnknown*
pbc As IntPtr, ' IBindCtx* optional
param5 As IntPtr, ' IBindStatusCallback* optional
grfHLNF As UInteger, ' DWORD
dwReserved As UInteger ' DWORD
) As Integer
End Function' szTarget : LPCWSTR optional
' szLocation : LPCWSTR optional
' szTargetFrameName : LPCWSTR optional
' pUnk : IUnknown*
' pbc : IBindCtx* optional
' param5 : IBindStatusCallback* optional
' grfHLNF : DWORD
' dwReserved : DWORD
Declare PtrSafe Function HlinkSimpleNavigateToString Lib "urlmon" ( _
ByVal szTarget As LongPtr, _
ByVal szLocation As LongPtr, _
ByVal szTargetFrameName As LongPtr, _
ByVal pUnk As LongPtr, _
ByVal pbc As LongPtr, _
ByVal param5 As LongPtr, _
ByVal grfHLNF As Long, _
ByVal dwReserved As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
HlinkSimpleNavigateToString = ctypes.windll.urlmon.HlinkSimpleNavigateToString
HlinkSimpleNavigateToString.restype = ctypes.c_int
HlinkSimpleNavigateToString.argtypes = [
wintypes.LPCWSTR, # szTarget : LPCWSTR optional
wintypes.LPCWSTR, # szLocation : LPCWSTR optional
wintypes.LPCWSTR, # szTargetFrameName : LPCWSTR optional
ctypes.c_void_p, # pUnk : IUnknown*
ctypes.c_void_p, # pbc : IBindCtx* optional
ctypes.c_void_p, # param5 : IBindStatusCallback* optional
wintypes.DWORD, # grfHLNF : DWORD
wintypes.DWORD, # dwReserved : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('urlmon.dll')
HlinkSimpleNavigateToString = Fiddle::Function.new(
lib['HlinkSimpleNavigateToString'],
[
Fiddle::TYPE_VOIDP, # szTarget : LPCWSTR optional
Fiddle::TYPE_VOIDP, # szLocation : LPCWSTR optional
Fiddle::TYPE_VOIDP, # szTargetFrameName : LPCWSTR optional
Fiddle::TYPE_VOIDP, # pUnk : IUnknown*
Fiddle::TYPE_VOIDP, # pbc : IBindCtx* optional
Fiddle::TYPE_VOIDP, # param5 : IBindStatusCallback* optional
-Fiddle::TYPE_INT, # grfHLNF : DWORD
-Fiddle::TYPE_INT, # dwReserved : DWORD
],
Fiddle::TYPE_INT)#[link(name = "urlmon")]
extern "system" {
fn HlinkSimpleNavigateToString(
szTarget: *const u16, // LPCWSTR optional
szLocation: *const u16, // LPCWSTR optional
szTargetFrameName: *const u16, // LPCWSTR optional
pUnk: *mut core::ffi::c_void, // IUnknown*
pbc: *mut core::ffi::c_void, // IBindCtx* optional
param5: *mut core::ffi::c_void, // IBindStatusCallback* optional
grfHLNF: u32, // DWORD
dwReserved: u32 // DWORD
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("urlmon.dll")]
public static extern int HlinkSimpleNavigateToString([MarshalAs(UnmanagedType.LPWStr)] string szTarget, [MarshalAs(UnmanagedType.LPWStr)] string szLocation, [MarshalAs(UnmanagedType.LPWStr)] string szTargetFrameName, IntPtr pUnk, IntPtr pbc, IntPtr param5, uint grfHLNF, uint dwReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'urlmon_HlinkSimpleNavigateToString' -Namespace Win32 -PassThru
# $api::HlinkSimpleNavigateToString(szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved)#uselib "urlmon.dll"
#func global HlinkSimpleNavigateToString "HlinkSimpleNavigateToString" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; HlinkSimpleNavigateToString szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved ; 戻り値は stat
; szTarget : LPCWSTR optional -> "sptr"
; szLocation : LPCWSTR optional -> "sptr"
; szTargetFrameName : LPCWSTR optional -> "sptr"
; pUnk : IUnknown* -> "sptr"
; pbc : IBindCtx* optional -> "sptr"
; param5 : IBindStatusCallback* optional -> "sptr"
; grfHLNF : DWORD -> "sptr"
; dwReserved : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "urlmon.dll"
#cfunc global HlinkSimpleNavigateToString "HlinkSimpleNavigateToString" wstr, wstr, wstr, sptr, sptr, sptr, int, int
; res = HlinkSimpleNavigateToString(szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved)
; szTarget : LPCWSTR optional -> "wstr"
; szLocation : LPCWSTR optional -> "wstr"
; szTargetFrameName : LPCWSTR optional -> "wstr"
; pUnk : IUnknown* -> "sptr"
; pbc : IBindCtx* optional -> "sptr"
; param5 : IBindStatusCallback* optional -> "sptr"
; grfHLNF : DWORD -> "int"
; dwReserved : DWORD -> "int"; HRESULT HlinkSimpleNavigateToString(LPCWSTR szTarget, LPCWSTR szLocation, LPCWSTR szTargetFrameName, IUnknown* pUnk, IBindCtx* pbc, IBindStatusCallback* param5, DWORD grfHLNF, DWORD dwReserved)
#uselib "urlmon.dll"
#cfunc global HlinkSimpleNavigateToString "HlinkSimpleNavigateToString" wstr, wstr, wstr, intptr, intptr, intptr, int, int
; res = HlinkSimpleNavigateToString(szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved)
; szTarget : LPCWSTR optional -> "wstr"
; szLocation : LPCWSTR optional -> "wstr"
; szTargetFrameName : LPCWSTR optional -> "wstr"
; pUnk : IUnknown* -> "intptr"
; pbc : IBindCtx* optional -> "intptr"
; param5 : IBindStatusCallback* optional -> "intptr"
; grfHLNF : DWORD -> "int"
; dwReserved : DWORD -> "int"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
urlmon = windows.NewLazySystemDLL("urlmon.dll")
procHlinkSimpleNavigateToString = urlmon.NewProc("HlinkSimpleNavigateToString")
)
// szTarget (LPCWSTR optional), szLocation (LPCWSTR optional), szTargetFrameName (LPCWSTR optional), pUnk (IUnknown*), pbc (IBindCtx* optional), param5 (IBindStatusCallback* optional), grfHLNF (DWORD), dwReserved (DWORD)
r1, _, err := procHlinkSimpleNavigateToString.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(szTarget))),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(szLocation))),
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(szTargetFrameName))),
uintptr(pUnk),
uintptr(pbc),
uintptr(param5),
uintptr(grfHLNF),
uintptr(dwReserved),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction HlinkSimpleNavigateToString(
szTarget: PWideChar; // LPCWSTR optional
szLocation: PWideChar; // LPCWSTR optional
szTargetFrameName: PWideChar; // LPCWSTR optional
pUnk: Pointer; // IUnknown*
pbc: Pointer; // IBindCtx* optional
param5: Pointer; // IBindStatusCallback* optional
grfHLNF: DWORD; // DWORD
dwReserved: DWORD // DWORD
): Integer; stdcall;
external 'urlmon.dll' name 'HlinkSimpleNavigateToString';result := DllCall("urlmon\HlinkSimpleNavigateToString"
, "WStr", szTarget ; LPCWSTR optional
, "WStr", szLocation ; LPCWSTR optional
, "WStr", szTargetFrameName ; LPCWSTR optional
, "Ptr", pUnk ; IUnknown*
, "Ptr", pbc ; IBindCtx* optional
, "Ptr", param5 ; IBindStatusCallback* optional
, "UInt", grfHLNF ; DWORD
, "UInt", dwReserved ; DWORD
, "Int") ; return: HRESULT●HlinkSimpleNavigateToString(szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved) = DLL("urlmon.dll", "int HlinkSimpleNavigateToString(char*, char*, char*, void*, void*, void*, dword, dword)")
# 呼び出し: HlinkSimpleNavigateToString(szTarget, szLocation, szTargetFrameName, pUnk, pbc, param5, grfHLNF, dwReserved)
# szTarget : LPCWSTR optional -> "char*"
# szLocation : LPCWSTR optional -> "char*"
# szTargetFrameName : LPCWSTR optional -> "char*"
# pUnk : IUnknown* -> "void*"
# pbc : IBindCtx* optional -> "void*"
# param5 : IBindStatusCallback* optional -> "void*"
# grfHLNF : DWORD -> "dword"
# dwReserved : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。