Win32 API 日本語リファレンス
ホームNetworkManagement.Dns › DnsReplaceRecordSetW

DnsReplaceRecordSetW

関数
DNSレコードセットを動的更新で置換する(Unicode)。
DLLDNSAPI.dll文字セットUnicode (-W)呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// DNSAPI.dll  (Unicode / -W)
#include <windows.h>

INT DnsReplaceRecordSetW(
    DNS_RECORDA* pReplaceSet,
    DWORD Options,
    HANDLE hContext,   // optional
    void* pExtraInfo,   // optional
    void* pReserved   // optional
);

パラメーター

名前方向
pReplaceSetDNS_RECORDA*in
OptionsDWORDin
hContextHANDLEinoptional
pExtraInfovoid*inoutoptional
pReservedvoid*inoutoptional

戻り値の型: INT

各言語での呼び出し定義

// DNSAPI.dll  (Unicode / -W)
#include <windows.h>

INT DnsReplaceRecordSetW(
    DNS_RECORDA* pReplaceSet,
    DWORD Options,
    HANDLE hContext,   // optional
    void* pExtraInfo,   // optional
    void* pReserved   // optional
);
[DllImport("DNSAPI.dll", CharSet = CharSet.Unicode, ExactSpelling = true)]
static extern int DnsReplaceRecordSetW(
    IntPtr pReplaceSet,   // DNS_RECORDA*
    uint Options,   // DWORD
    IntPtr hContext,   // HANDLE optional
    IntPtr pExtraInfo,   // void* optional, in/out
    IntPtr pReserved   // void* optional, in/out
);
<DllImport("DNSAPI.dll", CharSet:=CharSet.Unicode, ExactSpelling:=True)>
Public Shared Function DnsReplaceRecordSetW(
    pReplaceSet As IntPtr,   ' DNS_RECORDA*
    Options As UInteger,   ' DWORD
    hContext As IntPtr,   ' HANDLE optional
    pExtraInfo As IntPtr,   ' void* optional, in/out
    pReserved As IntPtr   ' void* optional, in/out
) As Integer
End Function
' pReplaceSet : DNS_RECORDA*
' Options : DWORD
' hContext : HANDLE optional
' pExtraInfo : void* optional, in/out
' pReserved : void* optional, in/out
Declare PtrSafe Function DnsReplaceRecordSetW Lib "dnsapi" ( _
    ByVal pReplaceSet As LongPtr, _
    ByVal Options As Long, _
    ByVal hContext As LongPtr, _
    ByVal pExtraInfo As LongPtr, _
    ByVal pReserved As LongPtr) As Long
' Unicode(W): 文字列は ByVal As LongPtr とし StrPtr(unicodeStr) を渡す
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DnsReplaceRecordSetW = ctypes.windll.dnsapi.DnsReplaceRecordSetW
DnsReplaceRecordSetW.restype = ctypes.c_int
DnsReplaceRecordSetW.argtypes = [
    ctypes.c_void_p,  # pReplaceSet : DNS_RECORDA*
    wintypes.DWORD,  # Options : DWORD
    wintypes.HANDLE,  # hContext : HANDLE optional
    ctypes.POINTER(None),  # pExtraInfo : void* optional, in/out
    ctypes.POINTER(None),  # pReserved : void* optional, in/out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('DNSAPI.dll')
DnsReplaceRecordSetW = Fiddle::Function.new(
  lib['DnsReplaceRecordSetW'],
  [
    Fiddle::TYPE_VOIDP,  # pReplaceSet : DNS_RECORDA*
    -Fiddle::TYPE_INT,  # Options : DWORD
    Fiddle::TYPE_VOIDP,  # hContext : HANDLE optional
    Fiddle::TYPE_VOIDP,  # pExtraInfo : void* optional, in/out
    Fiddle::TYPE_VOIDP,  # pReserved : void* optional, in/out
  ],
  Fiddle::TYPE_INT)
# Wide strings: pass str.encode("UTF-16LE") + "\x00\x00"
#[link(name = "dnsapi")]
extern "system" {
    fn DnsReplaceRecordSetW(
        pReplaceSet: *mut DNS_RECORDA,  // DNS_RECORDA*
        Options: u32,  // DWORD
        hContext: *mut core::ffi::c_void,  // HANDLE optional
        pExtraInfo: *mut (),  // void* optional, in/out
        pReserved: *mut ()  // void* optional, in/out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("DNSAPI.dll", CharSet = CharSet.Unicode)]
public static extern int DnsReplaceRecordSetW(IntPtr pReplaceSet, uint Options, IntPtr hContext, IntPtr pExtraInfo, IntPtr pReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'DNSAPI_DnsReplaceRecordSetW' -Namespace Win32 -PassThru
# $api::DnsReplaceRecordSetW(pReplaceSet, Options, hContext, pExtraInfo, pReserved)
#uselib "DNSAPI.dll"
#func global DnsReplaceRecordSetW "DnsReplaceRecordSetW" wptr, wptr, wptr, wptr, wptr
; DnsReplaceRecordSetW varptr(pReplaceSet), Options, hContext, pExtraInfo, pReserved   ; 戻り値は stat
; pReplaceSet : DNS_RECORDA* -> "wptr"
; Options : DWORD -> "wptr"
; hContext : HANDLE optional -> "wptr"
; pExtraInfo : void* optional, in/out -> "wptr"
; pReserved : void* optional, in/out -> "wptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "DNSAPI.dll"
#cfunc global DnsReplaceRecordSetW "DnsReplaceRecordSetW" var, int, sptr, sptr, sptr
; res = DnsReplaceRecordSetW(pReplaceSet, Options, hContext, pExtraInfo, pReserved)
; pReplaceSet : DNS_RECORDA* -> "var"
; Options : DWORD -> "int"
; hContext : HANDLE optional -> "sptr"
; pExtraInfo : void* optional, in/out -> "sptr"
; pReserved : void* optional, in/out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; INT DnsReplaceRecordSetW(DNS_RECORDA* pReplaceSet, DWORD Options, HANDLE hContext, void* pExtraInfo, void* pReserved)
#uselib "DNSAPI.dll"
#cfunc global DnsReplaceRecordSetW "DnsReplaceRecordSetW" var, int, intptr, intptr, intptr
; res = DnsReplaceRecordSetW(pReplaceSet, Options, hContext, pExtraInfo, pReserved)
; pReplaceSet : DNS_RECORDA* -> "var"
; Options : DWORD -> "int"
; hContext : HANDLE optional -> "intptr"
; pExtraInfo : void* optional, in/out -> "intptr"
; pReserved : void* optional, in/out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	dnsapi = windows.NewLazySystemDLL("DNSAPI.dll")
	procDnsReplaceRecordSetW = dnsapi.NewProc("DnsReplaceRecordSetW")
)

// pReplaceSet (DNS_RECORDA*), Options (DWORD), hContext (HANDLE optional), pExtraInfo (void* optional, in/out), pReserved (void* optional, in/out)
r1, _, err := procDnsReplaceRecordSetW.Call(
	uintptr(pReplaceSet),
	uintptr(Options),
	uintptr(hContext),
	uintptr(pExtraInfo),
	uintptr(pReserved),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // INT
function DnsReplaceRecordSetW(
  pReplaceSet: Pointer;   // DNS_RECORDA*
  Options: DWORD;   // DWORD
  hContext: THandle;   // HANDLE optional
  pExtraInfo: Pointer;   // void* optional, in/out
  pReserved: Pointer   // void* optional, in/out
): Integer; stdcall;
  external 'DNSAPI.dll' name 'DnsReplaceRecordSetW';
result := DllCall("DNSAPI\DnsReplaceRecordSetW"
    , "Ptr", pReplaceSet   ; DNS_RECORDA*
    , "UInt", Options   ; DWORD
    , "Ptr", hContext   ; HANDLE optional
    , "Ptr", pExtraInfo   ; void* optional, in/out
    , "Ptr", pReserved   ; void* optional, in/out
    , "Int")   ; return: INT
●DnsReplaceRecordSetW(pReplaceSet, Options, hContext, pExtraInfo, pReserved) = DLL("DNSAPI.dll", "int DnsReplaceRecordSetW(void*, dword, void*, void*, void*)")
# 呼び出し: DnsReplaceRecordSetW(pReplaceSet, Options, hContext, pExtraInfo, pReserved)
# pReplaceSet : DNS_RECORDA* -> "void*"
# Options : DWORD -> "dword"
# hContext : HANDLE optional -> "void*"
# pExtraInfo : void* optional, in/out -> "void*"
# pReserved : void* optional, in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※-W(Unicode)関数。なでしこ1はANSIのため -A 版の利用を推奨。