RPC_BINDING_VECTOR
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Count | DWORD | 4 | +0 | +0 | バインディング ハンドルの配列 BindingH に含まれるバインディング ハンドルの数です。 |
| BindingH | void* | 8/4 | +8 | +4 | Count 個の要素を含むバインディング ハンドルの配列です。 |
公式ドキュメント
RPC_BINDING_VECTOR 構造体には、サーバー アプリケーションがリモート プロシージャ コールを受信できるバインディング ハンドルの一覧が格納されます。
解説(Remarks)
バインディング ベクターには、カウント メンバー (Count) と、それに続くバインディング ハンドル (BindingH) 要素の配列が含まれます。
RPC ランタイム ライブラリは、サーバー アプリケーションがプロトコル シーケンスを登録するときにバインディング ハンドルを作成します。バインディング ベクターを取得するには、サーバー アプリケーションは RpcServerInqBindings を呼び出します。
クライアント アプリケーションは、 RpcNsBindingLookupNext を呼び出して、互換性のあるサーバーのバインディング ベクターをネーム サービス データベースから取得します。
どちらのルーチンでも、RPC ランタイム ライブラリがバインディング ベクター用のメモリを割り当てます。アプリケーションは RpcBindingVectorFree を呼び出してバインディング ベクターを解放します。
ベクターから個々のバインディング ハンドルを削除するには、アプリケーションはベクター内のその値を NULL に設定する必要があります。ベクター要素を NULL に設定する場合、アプリケーションは次のようにする必要があります。
- 個々のバインディングを解放します。
- Count の値は変更しません。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// RPC_BINDING_VECTOR (x64 16 / x86 8 バイト)
typedef struct RPC_BINDING_VECTOR {
DWORD Count;
void* BindingH[1];
} RPC_BINDING_VECTOR;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RPC_BINDING_VECTOR
{
public uint Count;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public IntPtr[] BindingH;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RPC_BINDING_VECTOR
Public Count As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public BindingH() As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class RPC_BINDING_VECTOR(ctypes.Structure):
_fields_ = [
("Count", wintypes.DWORD),
("BindingH", ctypes.c_void_p * 1),
]#[repr(C)]
pub struct RPC_BINDING_VECTOR {
pub Count: u32,
pub BindingH: [*mut core::ffi::c_void; 1],
}import "golang.org/x/sys/windows"
type RPC_BINDING_VECTOR struct {
Count uint32
BindingH [1]uintptr
}type
RPC_BINDING_VECTOR = record
Count: DWORD;
BindingH: array[0..0] of Pointer;
end;const RPC_BINDING_VECTOR = extern struct {
Count: u32,
BindingH: [1]?*anyopaque,
};type
RPC_BINDING_VECTOR {.bycopy.} = object
Count: uint32
BindingH: array[1, pointer]struct RPC_BINDING_VECTOR
{
uint Count;
void*[1] BindingH;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; RPC_BINDING_VECTOR サイズ: 8 バイト(x86)
dim st, 2 ; 4byte整数×2(構造体サイズ 8 / 4 切り上げ)
; Count : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; BindingH : void* (+4, 4byte) varptr(st)+4 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RPC_BINDING_VECTOR サイズ: 16 バイト(x64)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; Count : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; BindingH : void* (+8, 8byte) varptr(st)+8 を基点に操作(8byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RPC_BINDING_VECTOR
#field int Count
#field intptr BindingH 1
#endstruct
stdim st, RPC_BINDING_VECTOR ; NSTRUCT 変数を確保
st->Count = 100
mes "Count=" + st->Count