LDAPModW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| mod_op | DWORD | 4 | +0 | +0 | 実行する変更操作を示す、次のいずれかの値を指定します。 ビット単位のOR 演算子 (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 | LPWSTR | 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 | LPWSTR* | 8/4 | +0 | +0 | null で終わる文字列からなる、null で終わる配列へのポインター。配列の最後の要素は NULL ポインターでなければなりません。 |
| modv_bvals | LDAP_BERVAL** | 8/4 | +0 | +0 | berval ポインターの NULL で終わる配列へのポインター。配列の最後の要素は NULL ポインターでなければなりません。 - mod_op.LDAP_MOD_ADD (0x00)エントリに値を追加します。指定した値は、属性の既存の値の後ろに追加されます。 - mod_op.LDAP_MOD_DELETE (0x01)エントリ内の値を削除します。指定した値が、現在の属性値から削除されます。 - mod_op.LDAP_MOD_REPLACE (0x02)エントリ内の値を置き換えます。指定した値で既存の属性値が置き換えられます。 |
公式ドキュメント
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>
// LDAPModW (x64 24 / x86 12 バイト)
typedef struct LDAPModW {
DWORD mod_op;
LPWSTR mod_type;
_mod_vals_e__Union mod_vals;
} LDAPModW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LDAPModW
{
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 LDAPModW
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 LDAPModW(ctypes.Structure):
_fields_ = [
("mod_op", wintypes.DWORD),
("mod_type", ctypes.c_void_p),
("mod_vals", _mod_vals_e__Union),
]#[repr(C)]
pub struct LDAPModW {
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 LDAPModW struct {
mod_op uint32
mod_type uintptr
mod_vals _mod_vals_e__Union
}type
LDAPModW = record
mod_op: DWORD;
mod_type: Pointer;
mod_vals: _mod_vals_e__Union;
end;const LDAPModW = extern struct {
mod_op: u32,
mod_type: ?*anyopaque,
mod_vals: _mod_vals_e__Union,
};type
LDAPModW {.bycopy.} = object
mod_op: uint32
mod_type: pointer
mod_vals: _mod_vals_e__Unionstruct LDAPModW
{
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 レイアウト)
; LDAPModW サイズ: 12 バイト(x86)
dim st, 3 ; 4byte整数×3(構造体サイズ 12 / 4 切り上げ)
; mod_op : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; mod_type : LPWSTR (+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 レイアウト)
; LDAPModW サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; mod_op : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; mod_type : LPWSTR (+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 LDAPModW
#field int mod_op
#field intptr mod_type
#field byte mod_vals 8
#endstruct
stdim st, LDAPModW ; NSTRUCT 変数を確保
st->mod_op = 100
mes "mod_op=" + st->mod_op
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。