ホーム › Networking.WinSock › GetAddressByNameA
GetAddressByNameA
関数サービス名から対応するアドレス情報を取得する。
シグネチャ
// MSWSOCK.dll (ANSI / -A)
#include <windows.h>
INT GetAddressByNameA(
DWORD dwNameSpace,
GUID* lpServiceType,
LPSTR lpServiceName, // optional
INT* lpiProtocols, // optional
DWORD dwResolution,
SERVICE_ASYNC_INFO* lpServiceAsyncInfo, // optional
void* lpCsaddrBuffer,
DWORD* lpdwBufferLength,
LPSTR lpAliasBuffer, // optional
DWORD* lpdwAliasBufferLength
);パラメーター
| 名前 | 型 | 方向 |
|---|---|---|
| dwNameSpace | DWORD | in |
| lpServiceType | GUID* | in |
| lpServiceName | LPSTR | inoptional |
| lpiProtocols | INT* | inoptional |
| dwResolution | DWORD | in |
| lpServiceAsyncInfo | SERVICE_ASYNC_INFO* | inoptional |
| lpCsaddrBuffer | void* | out |
| lpdwBufferLength | DWORD* | inout |
| lpAliasBuffer | LPSTR | inoutoptional |
| lpdwAliasBufferLength | DWORD* | inout |
戻り値の型: INT
各言語での呼び出し定義
// MSWSOCK.dll (ANSI / -A)
#include <windows.h>
INT GetAddressByNameA(
DWORD dwNameSpace,
GUID* lpServiceType,
LPSTR lpServiceName, // optional
INT* lpiProtocols, // optional
DWORD dwResolution,
SERVICE_ASYNC_INFO* lpServiceAsyncInfo, // optional
void* lpCsaddrBuffer,
DWORD* lpdwBufferLength,
LPSTR lpAliasBuffer, // optional
DWORD* lpdwAliasBufferLength
);[DllImport("MSWSOCK.dll", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
static extern int GetAddressByNameA(
uint dwNameSpace, // DWORD
ref Guid lpServiceType, // GUID*
[MarshalAs(UnmanagedType.LPStr)] string lpServiceName, // LPSTR optional
IntPtr lpiProtocols, // INT* optional
uint dwResolution, // DWORD
IntPtr lpServiceAsyncInfo, // SERVICE_ASYNC_INFO* optional
IntPtr lpCsaddrBuffer, // void* out
ref uint lpdwBufferLength, // DWORD* in/out
[MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder lpAliasBuffer, // LPSTR optional, in/out
ref uint lpdwAliasBufferLength // DWORD* in/out
);<DllImport("MSWSOCK.dll", CharSet:=CharSet.Ansi, SetLastError:=True, ExactSpelling:=True)>
Public Shared Function GetAddressByNameA(
dwNameSpace As UInteger, ' DWORD
ByRef lpServiceType As Guid, ' GUID*
<MarshalAs(UnmanagedType.LPStr)> lpServiceName As String, ' LPSTR optional
lpiProtocols As IntPtr, ' INT* optional
dwResolution As UInteger, ' DWORD
lpServiceAsyncInfo As IntPtr, ' SERVICE_ASYNC_INFO* optional
lpCsaddrBuffer As IntPtr, ' void* out
ByRef lpdwBufferLength As UInteger, ' DWORD* in/out
<MarshalAs(UnmanagedType.LPStr)> lpAliasBuffer As System.Text.StringBuilder, ' LPSTR optional, in/out
ByRef lpdwAliasBufferLength As UInteger ' DWORD* in/out
) As Integer
End Function' dwNameSpace : DWORD
' lpServiceType : GUID*
' lpServiceName : LPSTR optional
' lpiProtocols : INT* optional
' dwResolution : DWORD
' lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional
' lpCsaddrBuffer : void* out
' lpdwBufferLength : DWORD* in/out
' lpAliasBuffer : LPSTR optional, in/out
' lpdwAliasBufferLength : DWORD* in/out
Declare PtrSafe Function GetAddressByNameA Lib "mswsock" ( _
ByVal dwNameSpace As Long, _
ByVal lpServiceType As LongPtr, _
ByVal lpServiceName As String, _
ByVal lpiProtocols As LongPtr, _
ByVal dwResolution As Long, _
ByVal lpServiceAsyncInfo As LongPtr, _
ByVal lpCsaddrBuffer As LongPtr, _
ByRef lpdwBufferLength As Long, _
ByVal lpAliasBuffer As String, _
ByRef lpdwAliasBufferLength As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
GetAddressByNameA = ctypes.windll.mswsock.GetAddressByNameA
GetAddressByNameA.restype = ctypes.c_int
GetAddressByNameA.argtypes = [
wintypes.DWORD, # dwNameSpace : DWORD
ctypes.c_void_p, # lpServiceType : GUID*
wintypes.LPCSTR, # lpServiceName : LPSTR optional
ctypes.POINTER(ctypes.c_int), # lpiProtocols : INT* optional
wintypes.DWORD, # dwResolution : DWORD
ctypes.c_void_p, # lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional
ctypes.POINTER(None), # lpCsaddrBuffer : void* out
ctypes.POINTER(wintypes.DWORD), # lpdwBufferLength : DWORD* in/out
wintypes.LPSTR, # lpAliasBuffer : LPSTR optional, in/out
ctypes.POINTER(wintypes.DWORD), # lpdwAliasBufferLength : DWORD* in/out
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('MSWSOCK.dll')
GetAddressByNameA = Fiddle::Function.new(
lib['GetAddressByNameA'],
[
-Fiddle::TYPE_INT, # dwNameSpace : DWORD
Fiddle::TYPE_VOIDP, # lpServiceType : GUID*
Fiddle::TYPE_VOIDP, # lpServiceName : LPSTR optional
Fiddle::TYPE_VOIDP, # lpiProtocols : INT* optional
-Fiddle::TYPE_INT, # dwResolution : DWORD
Fiddle::TYPE_VOIDP, # lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional
Fiddle::TYPE_VOIDP, # lpCsaddrBuffer : void* out
Fiddle::TYPE_VOIDP, # lpdwBufferLength : DWORD* in/out
Fiddle::TYPE_VOIDP, # lpAliasBuffer : LPSTR optional, in/out
Fiddle::TYPE_VOIDP, # lpdwAliasBufferLength : DWORD* in/out
],
Fiddle::TYPE_INT)#[link(name = "mswsock")]
extern "system" {
fn GetAddressByNameA(
dwNameSpace: u32, // DWORD
lpServiceType: *mut GUID, // GUID*
lpServiceName: *mut u8, // LPSTR optional
lpiProtocols: *mut i32, // INT* optional
dwResolution: u32, // DWORD
lpServiceAsyncInfo: *mut SERVICE_ASYNC_INFO, // SERVICE_ASYNC_INFO* optional
lpCsaddrBuffer: *mut (), // void* out
lpdwBufferLength: *mut u32, // DWORD* in/out
lpAliasBuffer: *mut u8, // LPSTR optional, in/out
lpdwAliasBufferLength: *mut u32 // DWORD* in/out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("MSWSOCK.dll", CharSet = CharSet.Ansi, SetLastError = true)]
public static extern int GetAddressByNameA(uint dwNameSpace, ref Guid lpServiceType, [MarshalAs(UnmanagedType.LPStr)] string lpServiceName, IntPtr lpiProtocols, uint dwResolution, IntPtr lpServiceAsyncInfo, IntPtr lpCsaddrBuffer, ref uint lpdwBufferLength, [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder lpAliasBuffer, ref uint lpdwAliasBufferLength);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSWSOCK_GetAddressByNameA' -Namespace Win32 -PassThru
# $api::GetAddressByNameA(dwNameSpace, lpServiceType, lpServiceName, lpiProtocols, dwResolution, lpServiceAsyncInfo, lpCsaddrBuffer, lpdwBufferLength, lpAliasBuffer, lpdwAliasBufferLength)#uselib "MSWSOCK.dll"
#func global GetAddressByNameA "GetAddressByNameA" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; GetAddressByNameA dwNameSpace, varptr(lpServiceType), lpServiceName, varptr(lpiProtocols), dwResolution, varptr(lpServiceAsyncInfo), lpCsaddrBuffer, varptr(lpdwBufferLength), varptr(lpAliasBuffer), varptr(lpdwAliasBufferLength) ; 戻り値は stat
; dwNameSpace : DWORD -> "sptr"
; lpServiceType : GUID* -> "sptr"
; lpServiceName : LPSTR optional -> "sptr"
; lpiProtocols : INT* optional -> "sptr"
; dwResolution : DWORD -> "sptr"
; lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "sptr"
; lpCsaddrBuffer : void* out -> "sptr"
; lpdwBufferLength : DWORD* in/out -> "sptr"
; lpAliasBuffer : LPSTR optional, in/out -> "sptr"
; lpdwAliasBufferLength : DWORD* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "MSWSOCK.dll" #cfunc global GetAddressByNameA "GetAddressByNameA" int, var, str, var, int, var, sptr, var, var, var ; res = GetAddressByNameA(dwNameSpace, lpServiceType, lpServiceName, lpiProtocols, dwResolution, lpServiceAsyncInfo, lpCsaddrBuffer, lpdwBufferLength, lpAliasBuffer, lpdwAliasBufferLength) ; dwNameSpace : DWORD -> "int" ; lpServiceType : GUID* -> "var" ; lpServiceName : LPSTR optional -> "str" ; lpiProtocols : INT* optional -> "var" ; dwResolution : DWORD -> "int" ; lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "var" ; lpCsaddrBuffer : void* out -> "sptr" ; lpdwBufferLength : DWORD* in/out -> "var" ; lpAliasBuffer : LPSTR optional, in/out -> "var" ; lpdwAliasBufferLength : DWORD* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MSWSOCK.dll" #cfunc global GetAddressByNameA "GetAddressByNameA" int, sptr, str, sptr, int, sptr, sptr, sptr, sptr, sptr ; res = GetAddressByNameA(dwNameSpace, varptr(lpServiceType), lpServiceName, varptr(lpiProtocols), dwResolution, varptr(lpServiceAsyncInfo), lpCsaddrBuffer, varptr(lpdwBufferLength), varptr(lpAliasBuffer), varptr(lpdwAliasBufferLength)) ; dwNameSpace : DWORD -> "int" ; lpServiceType : GUID* -> "sptr" ; lpServiceName : LPSTR optional -> "str" ; lpiProtocols : INT* optional -> "sptr" ; dwResolution : DWORD -> "int" ; lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "sptr" ; lpCsaddrBuffer : void* out -> "sptr" ; lpdwBufferLength : DWORD* in/out -> "sptr" ; lpAliasBuffer : LPSTR optional, in/out -> "sptr" ; lpdwAliasBufferLength : DWORD* in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; INT GetAddressByNameA(DWORD dwNameSpace, GUID* lpServiceType, LPSTR lpServiceName, INT* lpiProtocols, DWORD dwResolution, SERVICE_ASYNC_INFO* lpServiceAsyncInfo, void* lpCsaddrBuffer, DWORD* lpdwBufferLength, LPSTR lpAliasBuffer, DWORD* lpdwAliasBufferLength) #uselib "MSWSOCK.dll" #cfunc global GetAddressByNameA "GetAddressByNameA" int, var, str, var, int, var, intptr, var, var, var ; res = GetAddressByNameA(dwNameSpace, lpServiceType, lpServiceName, lpiProtocols, dwResolution, lpServiceAsyncInfo, lpCsaddrBuffer, lpdwBufferLength, lpAliasBuffer, lpdwAliasBufferLength) ; dwNameSpace : DWORD -> "int" ; lpServiceType : GUID* -> "var" ; lpServiceName : LPSTR optional -> "str" ; lpiProtocols : INT* optional -> "var" ; dwResolution : DWORD -> "int" ; lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "var" ; lpCsaddrBuffer : void* out -> "intptr" ; lpdwBufferLength : DWORD* in/out -> "var" ; lpAliasBuffer : LPSTR optional, in/out -> "var" ; lpdwAliasBufferLength : DWORD* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; INT GetAddressByNameA(DWORD dwNameSpace, GUID* lpServiceType, LPSTR lpServiceName, INT* lpiProtocols, DWORD dwResolution, SERVICE_ASYNC_INFO* lpServiceAsyncInfo, void* lpCsaddrBuffer, DWORD* lpdwBufferLength, LPSTR lpAliasBuffer, DWORD* lpdwAliasBufferLength) #uselib "MSWSOCK.dll" #cfunc global GetAddressByNameA "GetAddressByNameA" int, intptr, str, intptr, int, intptr, intptr, intptr, intptr, intptr ; res = GetAddressByNameA(dwNameSpace, varptr(lpServiceType), lpServiceName, varptr(lpiProtocols), dwResolution, varptr(lpServiceAsyncInfo), lpCsaddrBuffer, varptr(lpdwBufferLength), varptr(lpAliasBuffer), varptr(lpdwAliasBufferLength)) ; dwNameSpace : DWORD -> "int" ; lpServiceType : GUID* -> "intptr" ; lpServiceName : LPSTR optional -> "str" ; lpiProtocols : INT* optional -> "intptr" ; dwResolution : DWORD -> "int" ; lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "intptr" ; lpCsaddrBuffer : void* out -> "intptr" ; lpdwBufferLength : DWORD* in/out -> "intptr" ; lpAliasBuffer : LPSTR optional, in/out -> "intptr" ; lpdwAliasBufferLength : DWORD* in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
mswsock = windows.NewLazySystemDLL("MSWSOCK.dll")
procGetAddressByNameA = mswsock.NewProc("GetAddressByNameA")
)
// dwNameSpace (DWORD), lpServiceType (GUID*), lpServiceName (LPSTR optional), lpiProtocols (INT* optional), dwResolution (DWORD), lpServiceAsyncInfo (SERVICE_ASYNC_INFO* optional), lpCsaddrBuffer (void* out), lpdwBufferLength (DWORD* in/out), lpAliasBuffer (LPSTR optional, in/out), lpdwAliasBufferLength (DWORD* in/out)
r1, _, err := procGetAddressByNameA.Call(
uintptr(dwNameSpace),
uintptr(lpServiceType),
uintptr(unsafe.Pointer(windows.BytePtrFromString(lpServiceName))),
uintptr(lpiProtocols),
uintptr(dwResolution),
uintptr(lpServiceAsyncInfo),
uintptr(lpCsaddrBuffer),
uintptr(lpdwBufferLength),
uintptr(lpAliasBuffer),
uintptr(lpdwAliasBufferLength),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // INTfunction GetAddressByNameA(
dwNameSpace: DWORD; // DWORD
lpServiceType: PGUID; // GUID*
lpServiceName: PAnsiChar; // LPSTR optional
lpiProtocols: Pointer; // INT* optional
dwResolution: DWORD; // DWORD
lpServiceAsyncInfo: Pointer; // SERVICE_ASYNC_INFO* optional
lpCsaddrBuffer: Pointer; // void* out
lpdwBufferLength: Pointer; // DWORD* in/out
lpAliasBuffer: PAnsiChar; // LPSTR optional, in/out
lpdwAliasBufferLength: Pointer // DWORD* in/out
): Integer; stdcall;
external 'MSWSOCK.dll' name 'GetAddressByNameA';result := DllCall("MSWSOCK\GetAddressByNameA"
, "UInt", dwNameSpace ; DWORD
, "Ptr", lpServiceType ; GUID*
, "AStr", lpServiceName ; LPSTR optional
, "Ptr", lpiProtocols ; INT* optional
, "UInt", dwResolution ; DWORD
, "Ptr", lpServiceAsyncInfo ; SERVICE_ASYNC_INFO* optional
, "Ptr", lpCsaddrBuffer ; void* out
, "Ptr", lpdwBufferLength ; DWORD* in/out
, "Ptr", lpAliasBuffer ; LPSTR optional, in/out
, "Ptr", lpdwAliasBufferLength ; DWORD* in/out
, "Int") ; return: INT●GetAddressByNameA(dwNameSpace, lpServiceType, lpServiceName, lpiProtocols, dwResolution, lpServiceAsyncInfo, lpCsaddrBuffer, lpdwBufferLength, lpAliasBuffer, lpdwAliasBufferLength) = DLL("MSWSOCK.dll", "int GetAddressByNameA(dword, void*, char*, void*, dword, void*, void*, void*, char*, void*)")
# 呼び出し: GetAddressByNameA(dwNameSpace, lpServiceType, lpServiceName, lpiProtocols, dwResolution, lpServiceAsyncInfo, lpCsaddrBuffer, lpdwBufferLength, lpAliasBuffer, lpdwAliasBufferLength)
# dwNameSpace : DWORD -> "dword"
# lpServiceType : GUID* -> "void*"
# lpServiceName : LPSTR optional -> "char*"
# lpiProtocols : INT* optional -> "void*"
# dwResolution : DWORD -> "dword"
# lpServiceAsyncInfo : SERVICE_ASYNC_INFO* optional -> "void*"
# lpCsaddrBuffer : void* out -> "void*"
# lpdwBufferLength : DWORD* in/out -> "void*"
# lpAliasBuffer : LPSTR optional, in/out -> "char*"
# lpdwAliasBufferLength : DWORD* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。