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

DnsAcquireContextHandle_A

関数
動的更新用の資格情報コンテキストハンドルを取得する(ANSI)。
DLLDNSAPI.dll文字セットANSI (-A)呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// DNSAPI.dll  (ANSI / -A)
#include <windows.h>

INT DnsAcquireContextHandle_A(
    DWORD CredentialFlags,
    void* Credentials,   // optional
    HANDLE* pContext
);

パラメーター

名前方向
CredentialFlagsDWORDin
Credentialsvoid*inoptional
pContextHANDLE*out

戻り値の型: INT

各言語での呼び出し定義

// DNSAPI.dll  (ANSI / -A)
#include <windows.h>

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

DnsAcquireContextHandle_A = ctypes.windll.dnsapi.DnsAcquireContextHandle_A
DnsAcquireContextHandle_A.restype = ctypes.c_int
DnsAcquireContextHandle_A.argtypes = [
    wintypes.DWORD,  # CredentialFlags : DWORD
    ctypes.POINTER(None),  # Credentials : void* optional
    ctypes.c_void_p,  # pContext : HANDLE* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('DNSAPI.dll')
DnsAcquireContextHandle_A = Fiddle::Function.new(
  lib['DnsAcquireContextHandle_A'],
  [
    -Fiddle::TYPE_INT,  # CredentialFlags : DWORD
    Fiddle::TYPE_VOIDP,  # Credentials : void* optional
    Fiddle::TYPE_VOIDP,  # pContext : HANDLE* out
  ],
  Fiddle::TYPE_INT)
#[link(name = "dnsapi")]
extern "system" {
    fn DnsAcquireContextHandle_A(
        CredentialFlags: u32,  // DWORD
        Credentials: *mut (),  // void* optional
        pContext: *mut *mut core::ffi::c_void  // HANDLE* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("DNSAPI.dll", CharSet = CharSet.Ansi)]
public static extern int DnsAcquireContextHandle_A(uint CredentialFlags, IntPtr Credentials, IntPtr pContext);
"@
$api = Add-Type -MemberDefinition $sig -Name 'DNSAPI_DnsAcquireContextHandle_A' -Namespace Win32 -PassThru
# $api::DnsAcquireContextHandle_A(CredentialFlags, Credentials, pContext)
#uselib "DNSAPI.dll"
#func global DnsAcquireContextHandle_A "DnsAcquireContextHandle_A" sptr, sptr, sptr
; DnsAcquireContextHandle_A CredentialFlags, Credentials, pContext   ; 戻り値は stat
; CredentialFlags : DWORD -> "sptr"
; Credentials : void* optional -> "sptr"
; pContext : HANDLE* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "DNSAPI.dll"
#cfunc global DnsAcquireContextHandle_A "DnsAcquireContextHandle_A" int, sptr, sptr
; res = DnsAcquireContextHandle_A(CredentialFlags, Credentials, pContext)
; CredentialFlags : DWORD -> "int"
; Credentials : void* optional -> "sptr"
; pContext : HANDLE* out -> "sptr"
; INT DnsAcquireContextHandle_A(DWORD CredentialFlags, void* Credentials, HANDLE* pContext)
#uselib "DNSAPI.dll"
#cfunc global DnsAcquireContextHandle_A "DnsAcquireContextHandle_A" int, intptr, intptr
; res = DnsAcquireContextHandle_A(CredentialFlags, Credentials, pContext)
; CredentialFlags : DWORD -> "int"
; Credentials : void* optional -> "intptr"
; pContext : HANDLE* out -> "intptr"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	dnsapi = windows.NewLazySystemDLL("DNSAPI.dll")
	procDnsAcquireContextHandle_A = dnsapi.NewProc("DnsAcquireContextHandle_A")
)

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