ホーム › NetworkManagement.NetManagement › NetErrorLogWrite

NetErrorLogWrite

関数

サーバーのエラーログにエントリを書き込む。

DLLNETAPI32.dll呼出規約winapi

シグネチャ

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

DWORD NetErrorLogWrite(
    BYTE* Reserved1,   // optional
    DWORD Code,
    LPCWSTR Component,
    BYTE* Buffer,
    DWORD NumBytes,
    BYTE* MsgBuf,
    DWORD StrCount,
    BYTE* Reserved2   // optional
);

パラメーター

名前	型	方向
Reserved1	BYTE*	inoptional
Code	DWORD	in
Component	LPCWSTR	in
Buffer	BYTE*	in
NumBytes	DWORD	in
MsgBuf	BYTE*	in
StrCount	DWORD	in
Reserved2	BYTE*	inoptional

戻り値の型: DWORD

各言語での呼び出し定義

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

DWORD NetErrorLogWrite(
    BYTE* Reserved1,   // optional
    DWORD Code,
    LPCWSTR Component,
    BYTE* Buffer,
    DWORD NumBytes,
    BYTE* MsgBuf,
    DWORD StrCount,
    BYTE* Reserved2   // optional
);

[DllImport("NETAPI32.dll", ExactSpelling = true)]
static extern uint NetErrorLogWrite(
    IntPtr Reserved1,   // BYTE* optional
    uint Code,   // DWORD
    [MarshalAs(UnmanagedType.LPWStr)] string Component,   // LPCWSTR
    IntPtr Buffer,   // BYTE*
    uint NumBytes,   // DWORD
    IntPtr MsgBuf,   // BYTE*
    uint StrCount,   // DWORD
    IntPtr Reserved2   // BYTE* optional
);

<DllImport("NETAPI32.dll", ExactSpelling:=True)>
Public Shared Function NetErrorLogWrite(
    Reserved1 As IntPtr,   ' BYTE* optional
    Code As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPWStr)> Component As String,   ' LPCWSTR
    Buffer As IntPtr,   ' BYTE*
    NumBytes As UInteger,   ' DWORD
    MsgBuf As IntPtr,   ' BYTE*
    StrCount As UInteger,   ' DWORD
    Reserved2 As IntPtr   ' BYTE* optional
) As UInteger
End Function

' Reserved1 : BYTE* optional
' Code : DWORD
' Component : LPCWSTR
' Buffer : BYTE*
' NumBytes : DWORD
' MsgBuf : BYTE*
' StrCount : DWORD
' Reserved2 : BYTE* optional
Declare PtrSafe Function NetErrorLogWrite Lib "netapi32" ( _
    ByVal Reserved1 As LongPtr, _
    ByVal Code As Long, _
    ByVal Component As LongPtr, _
    ByVal Buffer As LongPtr, _
    ByVal NumBytes As Long, _
    ByVal MsgBuf As LongPtr, _
    ByVal StrCount As Long, _
    ByVal Reserved2 As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

NetErrorLogWrite = ctypes.windll.netapi32.NetErrorLogWrite
NetErrorLogWrite.restype = wintypes.DWORD
NetErrorLogWrite.argtypes = [
    ctypes.POINTER(ctypes.c_ubyte),  # Reserved1 : BYTE* optional
    wintypes.DWORD,  # Code : DWORD
    wintypes.LPCWSTR,  # Component : LPCWSTR
    ctypes.POINTER(ctypes.c_ubyte),  # Buffer : BYTE*
    wintypes.DWORD,  # NumBytes : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # MsgBuf : BYTE*
    wintypes.DWORD,  # StrCount : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # Reserved2 : BYTE* optional
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('NETAPI32.dll')
NetErrorLogWrite = Fiddle::Function.new(
  lib['NetErrorLogWrite'],
  [
    Fiddle::TYPE_VOIDP,  # Reserved1 : BYTE* optional
    -Fiddle::TYPE_INT,  # Code : DWORD
    Fiddle::TYPE_VOIDP,  # Component : LPCWSTR
    Fiddle::TYPE_VOIDP,  # Buffer : BYTE*
    -Fiddle::TYPE_INT,  # NumBytes : DWORD
    Fiddle::TYPE_VOIDP,  # MsgBuf : BYTE*
    -Fiddle::TYPE_INT,  # StrCount : DWORD
    Fiddle::TYPE_VOIDP,  # Reserved2 : BYTE* optional
  ],
  -Fiddle::TYPE_INT)

#[link(name = "netapi32")]
extern "system" {
    fn NetErrorLogWrite(
        Reserved1: *mut u8,  // BYTE* optional
        Code: u32,  // DWORD
        Component: *const u16,  // LPCWSTR
        Buffer: *mut u8,  // BYTE*
        NumBytes: u32,  // DWORD
        MsgBuf: *mut u8,  // BYTE*
        StrCount: u32,  // DWORD
        Reserved2: *mut u8  // BYTE* optional
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("NETAPI32.dll")]
public static extern uint NetErrorLogWrite(IntPtr Reserved1, uint Code, [MarshalAs(UnmanagedType.LPWStr)] string Component, IntPtr Buffer, uint NumBytes, IntPtr MsgBuf, uint StrCount, IntPtr Reserved2);
"@
$api = Add-Type -MemberDefinition $sig -Name 'NETAPI32_NetErrorLogWrite' -Namespace Win32 -PassThru
# $api::NetErrorLogWrite(Reserved1, Code, Component, Buffer, NumBytes, MsgBuf, StrCount, Reserved2)

#uselib "NETAPI32.dll"
#func global NetErrorLogWrite "NetErrorLogWrite" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; NetErrorLogWrite varptr(Reserved1), Code, Component, varptr(Buffer), NumBytes, varptr(MsgBuf), StrCount, varptr(Reserved2)   ; 戻り値は stat
; Reserved1 : BYTE* optional -> "sptr"
; Code : DWORD -> "sptr"
; Component : LPCWSTR -> "sptr"
; Buffer : BYTE* -> "sptr"
; NumBytes : DWORD -> "sptr"
; MsgBuf : BYTE* -> "sptr"
; StrCount : DWORD -> "sptr"
; Reserved2 : BYTE* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "NETAPI32.dll"
#cfunc global NetErrorLogWrite "NetErrorLogWrite" var, int, wstr, var, int, var, int, var
; res = NetErrorLogWrite(Reserved1, Code, Component, Buffer, NumBytes, MsgBuf, StrCount, Reserved2)
; Reserved1 : BYTE* optional -> "var"
; Code : DWORD -> "int"
; Component : LPCWSTR -> "wstr"
; Buffer : BYTE* -> "var"
; NumBytes : DWORD -> "int"
; MsgBuf : BYTE* -> "var"
; StrCount : DWORD -> "int"
; Reserved2 : BYTE* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "NETAPI32.dll"
#cfunc global NetErrorLogWrite "NetErrorLogWrite" sptr, int, wstr, sptr, int, sptr, int, sptr
; res = NetErrorLogWrite(varptr(Reserved1), Code, Component, varptr(Buffer), NumBytes, varptr(MsgBuf), StrCount, varptr(Reserved2))
; Reserved1 : BYTE* optional -> "sptr"
; Code : DWORD -> "int"
; Component : LPCWSTR -> "wstr"
; Buffer : BYTE* -> "sptr"
; NumBytes : DWORD -> "int"
; MsgBuf : BYTE* -> "sptr"
; StrCount : DWORD -> "int"
; Reserved2 : BYTE* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; DWORD NetErrorLogWrite(BYTE* Reserved1, DWORD Code, LPCWSTR Component, BYTE* Buffer, DWORD NumBytes, BYTE* MsgBuf, DWORD StrCount, BYTE* Reserved2)
#uselib "NETAPI32.dll"
#cfunc global NetErrorLogWrite "NetErrorLogWrite" var, int, wstr, var, int, var, int, var
; res = NetErrorLogWrite(Reserved1, Code, Component, Buffer, NumBytes, MsgBuf, StrCount, Reserved2)
; Reserved1 : BYTE* optional -> "var"
; Code : DWORD -> "int"
; Component : LPCWSTR -> "wstr"
; Buffer : BYTE* -> "var"
; NumBytes : DWORD -> "int"
; MsgBuf : BYTE* -> "var"
; StrCount : DWORD -> "int"
; Reserved2 : BYTE* optional -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; DWORD NetErrorLogWrite(BYTE* Reserved1, DWORD Code, LPCWSTR Component, BYTE* Buffer, DWORD NumBytes, BYTE* MsgBuf, DWORD StrCount, BYTE* Reserved2)
#uselib "NETAPI32.dll"
#cfunc global NetErrorLogWrite "NetErrorLogWrite" intptr, int, wstr, intptr, int, intptr, int, intptr
; res = NetErrorLogWrite(varptr(Reserved1), Code, Component, varptr(Buffer), NumBytes, varptr(MsgBuf), StrCount, varptr(Reserved2))
; Reserved1 : BYTE* optional -> "intptr"
; Code : DWORD -> "int"
; Component : LPCWSTR -> "wstr"
; Buffer : BYTE* -> "intptr"
; NumBytes : DWORD -> "int"
; MsgBuf : BYTE* -> "intptr"
; StrCount : DWORD -> "int"
; Reserved2 : BYTE* optional -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	netapi32 = windows.NewLazySystemDLL("NETAPI32.dll")
	procNetErrorLogWrite = netapi32.NewProc("NetErrorLogWrite")
)

// Reserved1 (BYTE* optional), Code (DWORD), Component (LPCWSTR), Buffer (BYTE*), NumBytes (DWORD), MsgBuf (BYTE*), StrCount (DWORD), Reserved2 (BYTE* optional)
r1, _, err := procNetErrorLogWrite.Call(
	uintptr(Reserved1),
	uintptr(Code),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(Component))),
	uintptr(Buffer),
	uintptr(NumBytes),
	uintptr(MsgBuf),
	uintptr(StrCount),
	uintptr(Reserved2),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD

function NetErrorLogWrite(
  Reserved1: Pointer;   // BYTE* optional
  Code: DWORD;   // DWORD
  Component: PWideChar;   // LPCWSTR
  Buffer: Pointer;   // BYTE*
  NumBytes: DWORD;   // DWORD
  MsgBuf: Pointer;   // BYTE*
  StrCount: DWORD;   // DWORD
  Reserved2: Pointer   // BYTE* optional
): DWORD; stdcall;
  external 'NETAPI32.dll' name 'NetErrorLogWrite';

result := DllCall("NETAPI32\NetErrorLogWrite"
    , "Ptr", Reserved1   ; BYTE* optional
    , "UInt", Code   ; DWORD
    , "WStr", Component   ; LPCWSTR
    , "Ptr", Buffer   ; BYTE*
    , "UInt", NumBytes   ; DWORD
    , "Ptr", MsgBuf   ; BYTE*
    , "UInt", StrCount   ; DWORD
    , "Ptr", Reserved2   ; BYTE* optional
    , "UInt")   ; return: DWORD

●NetErrorLogWrite(Reserved1, Code, Component, Buffer, NumBytes, MsgBuf, StrCount, Reserved2) = DLL("NETAPI32.dll", "dword NetErrorLogWrite(void*, dword, char*, void*, dword, void*, dword, void*)")
# 呼び出し: NetErrorLogWrite(Reserved1, Code, Component, Buffer, NumBytes, MsgBuf, StrCount, Reserved2)
# Reserved1 : BYTE* optional -> "void*"
# Code : DWORD -> "dword"
# Component : LPCWSTR -> "char*"
# Buffer : BYTE* -> "void*"
# NumBytes : DWORD -> "dword"
# MsgBuf : BYTE* -> "void*"
# StrCount : DWORD -> "dword"
# Reserved2 : BYTE* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。