LDAPModA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| mod_op | DWORD | 4 | +0 | +0 | 実行する変更操作を示す、次のいずれかの値を指定します。 ビット単位の OR 演算子を使用して操作の値と LDAP_MOD_BVALUES を組み合わせることで、mod_vals 共用体が modv_bvals メンバーを使用することを示せます。LDAP_MOD_BVALUES が設定されていない場合、共用体は modv_strvals メンバーを使用します。 LDAP_MOD_ADD (0x00)エントリに値を追加します。指定した値は、属性の既存の値の後ろに追加されます。 LDAP_MOD_DELETE (0x01)エントリ内の値を削除します。指定した値が現在の属性値から削除されます。 LDAP_MOD_REPLACE (0x02)エントリ内の値を置き換えます。指定した値で既存の属性値が置き換えられます。 |
| mod_type | LPSTR | 8/4 | +8 | +4 | 変更する属性の名前を指定する、null で終わる文字列へのポインター。 |
| mod_vals | _mod_vals_e__Union | 8/4 | +16 | +8 | 追加、削除、または置換する値(存在する場合)の配列へのポインター。mop_op に LDAP_MOD_BVALUES フラグが含まれていない場合、modv_strvals メンバーは null で終わる文字列の配列へのポインターです。mop_op に LDAP_MOD_BVALUES が含まれている場合、modv_bvals メンバーは berval ポインターの配列へのポインターとなり、バイナリ値を指定する場合に便利です。 |
共用体: _mod_vals_e__Union x64 8B / x86 4B
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| modv_strvals | LPSTR* | 8/4 | +0 | +0 | null で終わる文字列からなる、null で終わる配列へのポインター。配列の最後の要素は NULL ポインターでなければなりません。 |
| modv_bvals | LDAP_BERVAL** | 8/4 | +0 | +0 | NULL で終わる berval ポインターの配列へのポインター。配列の最後の要素は NULL ポインターでなければなりません。 |
公式ドキュメント
LDAPMod 構造体は、変更操作の実行に必要なデータを保持します。
解説(Remarks)
変更関数( ldap_add* または ldap_modify*)を呼び出す前に、LDAPMod 構造体のフィールドに値を設定します。
ldap_modify* を LDAP_MOD_REPLACE 操作で使用した場合、null ポインターを渡しても属性は削除されません。ただし、LDAP_MOD_DELETE は、mod_vals が NULL に設定されていると属性全体を削除します。
LDAPMod 構造体を ldap_add* 関数に渡す場合、意味を持つのは LDAP_MOD_BVALUES フラグだけです。新しいオブジェクトの作成は、そのオブジェクトへ値を追加することを意味します。
winldap.h ヘッダーは、LDAPMod を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI バージョンまたは Unicode バージョンを自動的に選択するエイリアスとして定義しています。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないわけではないコードを混在させて使用すると、コンパイル エラーや実行時エラーにつながる不一致が発生する可能性があります。詳細については、「関数プロトタイプの規約」を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// LDAPModA (x64 24 / x86 12 バイト)
typedef struct LDAPModA {
DWORD mod_op;
LPSTR mod_type;
_mod_vals_e__Union mod_vals;
} LDAPModA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LDAPModA
{
public uint mod_op;
public IntPtr mod_type;
public _mod_vals_e__Union mod_vals;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LDAPModA
Public mod_op As UInteger
Public mod_type As IntPtr
Public mod_vals As _mod_vals_e__Union
End Structureimport ctypes
from ctypes import wintypes
class LDAPModA(ctypes.Structure):
_fields_ = [
("mod_op", wintypes.DWORD),
("mod_type", ctypes.c_void_p),
("mod_vals", _mod_vals_e__Union),
]#[repr(C)]
pub struct LDAPModA {
pub mod_op: u32,
pub mod_type: *mut core::ffi::c_void,
pub mod_vals: _mod_vals_e__Union,
}import "golang.org/x/sys/windows"
type LDAPModA struct {
mod_op uint32
mod_type uintptr
mod_vals _mod_vals_e__Union
}type
LDAPModA = record
mod_op: DWORD;
mod_type: Pointer;
mod_vals: _mod_vals_e__Union;
end;const LDAPModA = extern struct {
mod_op: u32,
mod_type: ?*anyopaque,
mod_vals: _mod_vals_e__Union,
};type
LDAPModA {.bycopy.} = object
mod_op: uint32
mod_type: pointer
mod_vals: _mod_vals_e__Unionstruct LDAPModA
{
uint mod_op;
void* mod_type;
_mod_vals_e__Union mod_vals;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; LDAPModA サイズ: 12 バイト(x86)
dim st, 3 ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; mod_op : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; mod_type : LPSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; mod_vals : _mod_vals_e__Union (+8, 4byte) varptr(st)+8 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LDAPModA サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; mod_op : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; mod_type : LPSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; mod_vals : _mod_vals_e__Union (+16, 8byte) varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LDAPModA
#field int mod_op
#field intptr mod_type
#field byte mod_vals 8
#endstruct
stdim st, LDAPModA ; NSTRUCT 変数を確保
st->mod_op = 100
mes "mod_op=" + st->mod_op
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。