ホーム › Networking.Ldap › ber_printf
ber_printf
関数可変長引数書式指定に従ってデータをBER形式にエンコードする。
シグネチャ
// WLDAP32.dll
#include <windows.h>
INT ber_printf(
BerElement* pBerElement,
LPSTR fmt,
...
);
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| pBerElement | BerElement* | inout | エンコードされた BerElement 構造体へのポインター。 |
| fmt | LPSTR | in | エンコードの書式文字列。詳細については「解説」を参照してください。 |
戻り値の型: INT
公式ドキュメント
BER 要素をエンコードするために使用され、sprintf_s と類似しています。
戻り値
関数が成功した場合は、負でない数値が返されます。関数が失敗した場合は、-1 が返されます。
解説(Remarks)
書式文字列には、次の表に示す書式文字を含めることができます。
| 文字 | 説明 |
|---|---|
| t | タグ。次の引数は ber_tag_t で、BerElement に次に書き込まれる要素のタグを上書きするタグを指定します。これは複数の呼び出しにまたがって機能します。 |
| b | ブール値。次の引数は ber_int_t で、FALSE を表す 0 または TRUE を表す 1 を格納します。ブール要素が出力されます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x01U が使用されます。 |
| e | 列挙型。次の引数は ber_int_t で、列挙値を格納します。列挙要素が出力されます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x0AU が使用されます。 |
| i | 整数。次の引数は ber_int_t で、整数値を格納します。整数要素が出力されます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x02U が使用されます。 |
| n | NULL。引数は必要ありません。ASN.1 の NULL 要素が出力されます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x05U が使用されます。 |
| o | オクテット文字列。次の 2 つの引数は char* と、それに続く文字列の長さを表す ber_len_t です。文字列には NULL バイトが含まれていてもよく、ゼロ終端されている必要はありません。オクテット文字列要素が出力され、文字列データに対する文字形式の変換は行われません。NULL のオクテット文字列要素が必要な場合は、NULL ポインターと長さ 0 を渡すことができます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x04U が使用されます。 |
| s | オクテット文字列。次の引数は、ゼロ終端された ANSI 文字列を指す char* です。 ANSI 文字列の文字は UTF-8 形式に変換され、末尾の '\0' (null) バイトを含まないオクテット文字列要素が出力されます。 NULL のオクテット文字列要素が必要な場合は、NULL ポインターを渡すことができます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x04U が使用されます。 |
| v | 複数のオクテット文字列。次の引数は char** で、ゼロ終端された ANSI 文字列を指す char* ポインターの配列です。配列の最後の要素は NULL ポインターである必要があります。オクテット文字列には末尾の '\0' (null) バイトは含まれません。実際の SEQUENCE OF オクテット文字列を得るには、{v} のような構成を使用することに注意してください。この書式文字と t 書式修飾子を組み合わせて使用することはできません。 |
| V | 複数のオクテット文字列。berval* の NULL 終端配列を指定します。実際の SEQUENCE OF オクテット文字列を得るには、{v} のような構成を使用することに注意してください。この書式文字と t 書式修飾子を組み合わせて使用することはできません。 |
| X | ビット文字列。次の 2 つの引数は、ビット文字列の先頭を指す char* ポインターと、それに続くビット文字列内のビット数を格納する ber_len_t です。ビット文字列要素が出力されます。この書式文字の前に t 書式修飾子が指定されていない場合、要素にはタグ 0x03U が使用されます。 |
| { | シーケンスの開始。引数は必要ありません。この書式文字の前に t 書式修飾子が指定されていない場合、タグ 0x30U が使用されます。 |
| } | シーケンスの終了。引数は必要ありません。この書式文字と t 書式修飾子を組み合わせて使用することはできません。 |
| [ | セットの開始。引数は必要ありません。この書式文字の前に t 書式修飾子が指定されていない場合、タグ 0x31U が使用されます。 |
| ] | セットの終了。引数は必要ありません。この書式文字と t 書式修飾子を組み合わせて使用することはできません。 |
各左中かっこ ({) 文字は、同じ書式文字列内の後続の右中かっこ (}) 文字、または対象の BerElement に対する以降の ber_printf 呼び出しの書式文字列内にある右中かっこ文字と対にする必要があります。左角かっこ ([) 文字と右角かっこ (]) 文字についても同様です。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// WLDAP32.dll
#include <windows.h>
INT ber_printf(
BerElement* pBerElement,
LPSTR fmt,
...
);
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。[DllImport("WLDAP32.dll", ExactSpelling = true, CallingConvention = CallingConvention.Cdecl)]
static extern int ber_printf(
IntPtr pBerElement, // BerElement* in/out
[MarshalAs(UnmanagedType.LPStr)] string fmt, // LPSTR
__arglist
);
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。<DllImport("WLDAP32.dll", ExactSpelling:=True, CallingConvention:=CallingConvention.Cdecl)>
Public Shared Function ber_printf(
pBerElement As IntPtr, ' BerElement* in/out
<MarshalAs(UnmanagedType.LPStr)> fmt As String ' LPSTR
) As Integer
End Function
' ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。' pBerElement : BerElement* in/out
' fmt : LPSTR
Declare PtrSafe Function ber_printf Lib "wldap32" ( _
ByVal pBerElement As LongPtr, _
ByVal fmt As String) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
' ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。import ctypes
from ctypes import wintypes
ber_printf = ctypes.cdll.wldap32.ber_printf
ber_printf.restype = ctypes.c_int
ber_printf.argtypes = [
ctypes.c_void_p, # pBerElement : BerElement* in/out
wintypes.LPCSTR, # fmt : LPSTR
]
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('WLDAP32.dll')
ber_printf = Fiddle::Function.new(
lib['ber_printf'],
[
Fiddle::TYPE_VOIDP, # pBerElement : BerElement* in/out
Fiddle::TYPE_VOIDP, # fmt : LPSTR
],
Fiddle::TYPE_INT, Fiddle::Function::CDECL)
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。#[link(name = "wldap32")]
extern "C" {
fn ber_printf(
pBerElement: *mut BerElement, // BerElement* in/out
fmt: *mut u8, // LPSTR
...
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。$sig = @"
[DllImport("WLDAP32.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int ber_printf(IntPtr pBerElement, [MarshalAs(UnmanagedType.LPStr)] string fmt);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WLDAP32_ber_printf' -Namespace Win32 -PassThru
# $api::ber_printf(pBerElement, fmt)
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。#uselib "WLDAP32.dll"
#func global ber_printf "ber_printf" sptr, sptr
; ber_printf varptr(pBerElement), fmt ; 戻り値は stat
; pBerElement : BerElement* in/out -> "sptr"
; fmt : LPSTR -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。出力引数:
#uselib "WLDAP32.dll" #cfunc global ber_printf "ber_printf" var, str ; res = ber_printf(pBerElement, fmt) ; pBerElement : BerElement* in/out -> "var" ; fmt : LPSTR -> "str" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。 ; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。#uselib "WLDAP32.dll" #cfunc global ber_printf "ber_printf" sptr, str ; res = ber_printf(varptr(pBerElement), fmt) ; pBerElement : BerElement* in/out -> "sptr" ; fmt : LPSTR -> "str" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。
出力引数:
; INT ber_printf(BerElement* pBerElement, LPSTR fmt) #uselib "WLDAP32.dll" #cfunc global ber_printf "ber_printf" var, str ; res = ber_printf(pBerElement, fmt) ; pBerElement : BerElement* in/out -> "var" ; fmt : LPSTR -> "str" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。 ; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。; INT ber_printf(BerElement* pBerElement, LPSTR fmt) #uselib "WLDAP32.dll" #cfunc global ber_printf "ber_printf" intptr, str ; res = ber_printf(varptr(pBerElement), fmt) ; pBerElement : BerElement* in/out -> "intptr" ; fmt : LPSTR -> "str" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。 ; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
wldap32 = windows.NewLazySystemDLL("WLDAP32.dll")
procber_printf = wldap32.NewProc("ber_printf")
)
// pBerElement (BerElement* in/out), fmt (LPSTR)
r1, _, err := procber_printf.Call(
uintptr(pBerElement),
uintptr(unsafe.Pointer(windows.BytePtrFromString(fmt))),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // INT
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。function ber_printf(
pBerElement: Pointer; // BerElement* in/out
fmt: PAnsiChar // LPSTR
): Integer; cdecl; varargs;
external 'WLDAP32.dll' name 'ber_printf';
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。result := DllCall("WLDAP32\ber_printf"
, "Ptr", pBerElement ; BerElement* in/out
, "AStr", fmt ; LPSTR
, "Cdecl Int") ; return: INT
; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。●ber_printf(pBerElement, fmt) = DLL("WLDAP32.dll", "int ber_printf(void*, char*)")
# 呼び出し: ber_printf(pBerElement, fmt)
# pBerElement : BerElement* in/out -> "void*"
# fmt : LPSTR -> "char*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
# ※cdecl関数。DLL()宣言はstdcall前提。cdeclは EXEC_PTR(`cdecl`,…) を使用。
# ※可変長引数。DLL()は固定引数のみ。追加引数は EXEC_PTR で渡してください。
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。const std = @import("std");
extern "wldap32" fn ber_printf(
pBerElement: [*c]BerElement, // BerElement* in/out
fmt: [*c]const u8, // LPSTR
...
) callconv(.c) i32;
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。proc ber_printf(
pBerElement: ptr BerElement, # BerElement* in/out
fmt: cstring # LPSTR
): int32 {.importc: "ber_printf", cdecl, varargs, dynlib: "WLDAP32.dll".}
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。pragma(lib, "wldap32");
extern(C)
int ber_printf(
BerElement* pBerElement, // BerElement* in/out
const(char)* fmt, // LPSTR
...
);
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。ccall((:ber_printf, "WLDAP32.dll"), Int32,
(Ptr{BerElement}, Cstring),
pBerElement, fmt)
# pBerElement : BerElement* in/out -> Ptr{BerElement}
# fmt : LPSTR -> Cstring
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。local ffi = require("ffi")
ffi.cdef[[
int32_t ber_printf(
void* pBerElement,
const char* fmt,
...);
]]
local wldap32 = ffi.load("wldap32")
-- wldap32.ber_printf(pBerElement, fmt)
-- pBerElement : BerElement* in/out
-- fmt : LPSTR
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
-- ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。const koffi = require('koffi');
const lib = koffi.load('WLDAP32.dll');
const ber_printf = lib.func('__cdecl', 'ber_printf', 'int32_t', ['void *', 'str', '...']);
// ber_printf(pBerElement, fmt)
// pBerElement : BerElement* in/out -> 'void *'
// fmt : LPSTR -> 'str'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。const lib = Deno.dlopen("WLDAP32.dll", {
ber_printf: { parameters: ["pointer", "buffer"], result: "i32" },
});
// lib.symbols.ber_printf(pBerElement, fmt)
// pBerElement : BerElement* in/out -> "pointer"
// fmt : LPSTR -> "buffer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。<?php
$ffi = FFI::cdef(<<<C
int32_t ber_printf(
void* pBerElement,
const char* fmt,
...);
C, "WLDAP32.dll");
// $ffi->ber_printf(pBerElement, fmt);
// pBerElement : BerElement* in/out
// fmt : LPSTR
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Wldap32 extends Library {
Wldap32 INSTANCE = Native.load("wldap32", Wldap32.class);
int ber_printf(
Pointer pBerElement, // BerElement* in/out
String fmt, // LPSTR
Object... args // 可変長引数(printf形式)
);
}
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。@[Link("wldap32")]
lib LibWLDAP32
fun ber_printf = ber_printf(
pBerElement : BerElement*, # BerElement* in/out
fmt : UInt8*, # LPSTR
...
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef ber_printfNative = Int32 Function(Pointer<Void>, Pointer<Utf8>);
typedef ber_printfDart = int Function(Pointer<Void>, Pointer<Utf8>);
final ber_printf = DynamicLibrary.open('WLDAP32.dll')
.lookupFunction<ber_printfNative, ber_printfDart>('ber_printf');
// pBerElement : BerElement* in/out -> Pointer<Void>
// fmt : LPSTR -> Pointer<Utf8>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。{$mode objfpc}{$H+}
function ber_printf(
pBerElement: Pointer; // BerElement* in/out
fmt: PAnsiChar // LPSTR
): Integer; cdecl; varargs;
external 'WLDAP32.dll' name 'ber_printf';
// ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import ccall safe "ber_printf"
c_ber_printf :: Ptr () -> CString -> IO Int32
-- pBerElement : BerElement* in/out -> Ptr ()
-- fmt : LPSTR -> CString
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
-- ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。open Ctypes
open Foreign
let ber_printf =
foreign "ber_printf"
((ptr void) @-> string @-> returning int32_t)
(* pBerElement : BerElement* in/out -> (ptr void) *)
(* fmt : LPSTR -> string *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(* ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。(cffi:define-foreign-library wldap32 (t "WLDAP32.dll"))
(cffi:use-foreign-library wldap32)
(cffi:defcfun ("ber_printf" ber-printf :convention :cdecl) :int32
(p-ber-element :pointer) ; BerElement* in/out
(fmt :string) ; LPSTR
&rest) ; 可変長引数(printf形式)
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
; ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。use Win32::API;
my $ber_printf = Win32::API::More->new('WLDAP32',
'int ber_printf(LPVOID pBerElement, LPCSTR fmt)');
# my $ret = $ber_printf->Call($pBerElement, $fmt);
# pBerElement : BerElement* in/out -> LPVOID
# fmt : LPSTR -> LPCSTR
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。
# ※可変長引数(printf形式・cdecl)。上記の固定引数の後に、書式に応じた引数を追加で渡します。関連項目
公式の関連項目
- f ber_scanf — 書式指定に従ってBER形式のデータをデコードする。
- s LDAP_BERVAL
使用する型