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

DnsModifyRecordsInSet_UTF8

関数
レコードセットを動的更新で追加・削除する(UTF-8)。
DLLDNSAPI.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

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

INT DnsModifyRecordsInSet_UTF8(
    DNS_RECORDA* pAddRecords,   // optional
    DNS_RECORDA* pDeleteRecords,   // optional
    DWORD Options,
    HANDLE hCredentials,   // optional
    void* pExtraList,   // optional
    void* pReserved   // optional
);

パラメーター

名前方向
pAddRecordsDNS_RECORDA*inoptional
pDeleteRecordsDNS_RECORDA*inoptional
OptionsDWORDin
hCredentialsHANDLEinoptional
pExtraListvoid*inoutoptional
pReservedvoid*inoutoptional

戻り値の型: INT

各言語での呼び出し定義

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

INT DnsModifyRecordsInSet_UTF8(
    DNS_RECORDA* pAddRecords,   // optional
    DNS_RECORDA* pDeleteRecords,   // optional
    DWORD Options,
    HANDLE hCredentials,   // optional
    void* pExtraList,   // optional
    void* pReserved   // optional
);
[DllImport("DNSAPI.dll", ExactSpelling = true)]
static extern int DnsModifyRecordsInSet_UTF8(
    IntPtr pAddRecords,   // DNS_RECORDA* optional
    IntPtr pDeleteRecords,   // DNS_RECORDA* optional
    uint Options,   // DWORD
    IntPtr hCredentials,   // HANDLE optional
    IntPtr pExtraList,   // void* optional, in/out
    IntPtr pReserved   // void* optional, in/out
);
<DllImport("DNSAPI.dll", ExactSpelling:=True)>
Public Shared Function DnsModifyRecordsInSet_UTF8(
    pAddRecords As IntPtr,   ' DNS_RECORDA* optional
    pDeleteRecords As IntPtr,   ' DNS_RECORDA* optional
    Options As UInteger,   ' DWORD
    hCredentials As IntPtr,   ' HANDLE optional
    pExtraList As IntPtr,   ' void* optional, in/out
    pReserved As IntPtr   ' void* optional, in/out
) As Integer
End Function
' pAddRecords : DNS_RECORDA* optional
' pDeleteRecords : DNS_RECORDA* optional
' Options : DWORD
' hCredentials : HANDLE optional
' pExtraList : void* optional, in/out
' pReserved : void* optional, in/out
Declare PtrSafe Function DnsModifyRecordsInSet_UTF8 Lib "dnsapi" ( _
    ByVal pAddRecords As LongPtr, _
    ByVal pDeleteRecords As LongPtr, _
    ByVal Options As Long, _
    ByVal hCredentials As LongPtr, _
    ByVal pExtraList As LongPtr, _
    ByVal pReserved As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DnsModifyRecordsInSet_UTF8 = ctypes.windll.dnsapi.DnsModifyRecordsInSet_UTF8
DnsModifyRecordsInSet_UTF8.restype = ctypes.c_int
DnsModifyRecordsInSet_UTF8.argtypes = [
    ctypes.c_void_p,  # pAddRecords : DNS_RECORDA* optional
    ctypes.c_void_p,  # pDeleteRecords : DNS_RECORDA* optional
    wintypes.DWORD,  # Options : DWORD
    wintypes.HANDLE,  # hCredentials : HANDLE optional
    ctypes.POINTER(None),  # pExtraList : void* optional, in/out
    ctypes.POINTER(None),  # pReserved : void* optional, in/out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('DNSAPI.dll')
DnsModifyRecordsInSet_UTF8 = Fiddle::Function.new(
  lib['DnsModifyRecordsInSet_UTF8'],
  [
    Fiddle::TYPE_VOIDP,  # pAddRecords : DNS_RECORDA* optional
    Fiddle::TYPE_VOIDP,  # pDeleteRecords : DNS_RECORDA* optional
    -Fiddle::TYPE_INT,  # Options : DWORD
    Fiddle::TYPE_VOIDP,  # hCredentials : HANDLE optional
    Fiddle::TYPE_VOIDP,  # pExtraList : void* optional, in/out
    Fiddle::TYPE_VOIDP,  # pReserved : void* optional, in/out
  ],
  Fiddle::TYPE_INT)
#[link(name = "dnsapi")]
extern "system" {
    fn DnsModifyRecordsInSet_UTF8(
        pAddRecords: *mut DNS_RECORDA,  // DNS_RECORDA* optional
        pDeleteRecords: *mut DNS_RECORDA,  // DNS_RECORDA* optional
        Options: u32,  // DWORD
        hCredentials: *mut core::ffi::c_void,  // HANDLE optional
        pExtraList: *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")]
public static extern int DnsModifyRecordsInSet_UTF8(IntPtr pAddRecords, IntPtr pDeleteRecords, uint Options, IntPtr hCredentials, IntPtr pExtraList, IntPtr pReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'DNSAPI_DnsModifyRecordsInSet_UTF8' -Namespace Win32 -PassThru
# $api::DnsModifyRecordsInSet_UTF8(pAddRecords, pDeleteRecords, Options, hCredentials, pExtraList, pReserved)
#uselib "DNSAPI.dll"
#func global DnsModifyRecordsInSet_UTF8 "DnsModifyRecordsInSet_UTF8" sptr, sptr, sptr, sptr, sptr, sptr
; DnsModifyRecordsInSet_UTF8 varptr(pAddRecords), varptr(pDeleteRecords), Options, hCredentials, pExtraList, pReserved   ; 戻り値は stat
; pAddRecords : DNS_RECORDA* optional -> "sptr"
; pDeleteRecords : DNS_RECORDA* optional -> "sptr"
; Options : DWORD -> "sptr"
; hCredentials : HANDLE optional -> "sptr"
; pExtraList : void* optional, in/out -> "sptr"
; pReserved : void* optional, in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "DNSAPI.dll"
#cfunc global DnsModifyRecordsInSet_UTF8 "DnsModifyRecordsInSet_UTF8" var, var, int, sptr, sptr, sptr
; res = DnsModifyRecordsInSet_UTF8(pAddRecords, pDeleteRecords, Options, hCredentials, pExtraList, pReserved)
; pAddRecords : DNS_RECORDA* optional -> "var"
; pDeleteRecords : DNS_RECORDA* optional -> "var"
; Options : DWORD -> "int"
; hCredentials : HANDLE optional -> "sptr"
; pExtraList : void* optional, in/out -> "sptr"
; pReserved : void* optional, in/out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; INT DnsModifyRecordsInSet_UTF8(DNS_RECORDA* pAddRecords, DNS_RECORDA* pDeleteRecords, DWORD Options, HANDLE hCredentials, void* pExtraList, void* pReserved)
#uselib "DNSAPI.dll"
#cfunc global DnsModifyRecordsInSet_UTF8 "DnsModifyRecordsInSet_UTF8" var, var, int, intptr, intptr, intptr
; res = DnsModifyRecordsInSet_UTF8(pAddRecords, pDeleteRecords, Options, hCredentials, pExtraList, pReserved)
; pAddRecords : DNS_RECORDA* optional -> "var"
; pDeleteRecords : DNS_RECORDA* optional -> "var"
; Options : DWORD -> "int"
; hCredentials : HANDLE optional -> "intptr"
; pExtraList : 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")
	procDnsModifyRecordsInSet_UTF8 = dnsapi.NewProc("DnsModifyRecordsInSet_UTF8")
)

// pAddRecords (DNS_RECORDA* optional), pDeleteRecords (DNS_RECORDA* optional), Options (DWORD), hCredentials (HANDLE optional), pExtraList (void* optional, in/out), pReserved (void* optional, in/out)
r1, _, err := procDnsModifyRecordsInSet_UTF8.Call(
	uintptr(pAddRecords),
	uintptr(pDeleteRecords),
	uintptr(Options),
	uintptr(hCredentials),
	uintptr(pExtraList),
	uintptr(pReserved),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // INT
function DnsModifyRecordsInSet_UTF8(
  pAddRecords: Pointer;   // DNS_RECORDA* optional
  pDeleteRecords: Pointer;   // DNS_RECORDA* optional
  Options: DWORD;   // DWORD
  hCredentials: THandle;   // HANDLE optional
  pExtraList: Pointer;   // void* optional, in/out
  pReserved: Pointer   // void* optional, in/out
): Integer; stdcall;
  external 'DNSAPI.dll' name 'DnsModifyRecordsInSet_UTF8';
result := DllCall("DNSAPI\DnsModifyRecordsInSet_UTF8"
    , "Ptr", pAddRecords   ; DNS_RECORDA* optional
    , "Ptr", pDeleteRecords   ; DNS_RECORDA* optional
    , "UInt", Options   ; DWORD
    , "Ptr", hCredentials   ; HANDLE optional
    , "Ptr", pExtraList   ; void* optional, in/out
    , "Ptr", pReserved   ; void* optional, in/out
    , "Int")   ; return: INT
●DnsModifyRecordsInSet_UTF8(pAddRecords, pDeleteRecords, Options, hCredentials, pExtraList, pReserved) = DLL("DNSAPI.dll", "int DnsModifyRecordsInSet_UTF8(void*, void*, dword, void*, void*, void*)")
# 呼び出し: DnsModifyRecordsInSet_UTF8(pAddRecords, pDeleteRecords, Options, hCredentials, pExtraList, pReserved)
# pAddRecords : DNS_RECORDA* optional -> "void*"
# pDeleteRecords : DNS_RECORDA* optional -> "void*"
# Options : DWORD -> "dword"
# hCredentials : HANDLE optional -> "void*"
# pExtraList : void* optional, in/out -> "void*"
# pReserved : void* optional, in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。