ホーム › NetworkManagement.P2P › PEER_SECURITY_INTERFACE
PEER_SECURITY_INTERFACE
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | 構造体のサイズを指定します。値には sizeof(PEER_SECURITY_INTERFACE) を設定します。このメンバーは必須であり、既定値はありません。 |
| pwzSspFilename | LPWSTR | 8/4 | +8 | +4 | SSP インターフェイスを実装する .DLL の完全なパスとファイル名を指定します。SSP インターフェイスの詳細については、SSPI のドキュメントを参照してください。 |
| pwzPackageName | LPWSTR | 8/4 | +16 | +8 | 使用する SSP 内のセキュリティモジュールの ID を指定します。 |
| cbSecurityInfo | DWORD | 4 | +24 | +12 | pbSecurityInfo メンバーのバイト数を指定します。 pbSecurityInfo が NULL の場合、このメンバーは必須ではありません。ただし、pbSecurityInfo が NULL でない場合は、このメンバーに値を設定しなければなりません。 |
| pbSecurityInfo | BYTE* | 8/4 | +32 | +16 | ピアグラフの作成またはオープンに使用される情報を格納するバッファーへのポインターです。このメンバーは省略可能で、NULL を指定できます。 pbSecurityInfo が指すセキュリティデータ BLOB はコピーされた後、SSPI 関数 AcquireCredentialsHandle の呼び出しに渡されます。 |
| pvContext | void* | 8/4 | +40 | +20 | セキュリティコンテキストへのポインターです。このセキュリティコンテキストは、PFNPEER_VALIDATE_RECORD、PFNPEER_FREE_SECURITY_DATA、および PFNPEER_SECURE_RECORD に最初のパラメーターとして渡されます。このメンバーは省略可能で、NULL を指定できます。 |
| pfnValidateRecord | PFNPEER_VALIDATE_RECORD | 8/4 | +48 | +24 | レコードの検証が必要になったときに呼び出されるコールバック関数へのポインターです。このメンバーは省略可能で、NULL を指定できます。pfnSecureRecord が NULL の場合は、このメンバーも NULL でなければなりません。 |
| pfnSecureRecord | PFNPEER_SECURE_RECORD | 8/4 | +56 | +28 | レコードをセキュリティ保護する必要があるときに呼び出されるコールバック関数へのポインターです。このメンバーは省略可能で、NULL を指定できます。pfnValidateRecord が NULL の場合は、このメンバーも NULL でなければなりません。 |
| pfnFreeSecurityData | PFNPEER_FREE_SECURITY_DATA | 8/4 | +64 | +32 | pfnSecureRecord が指すコールバックによって割り当てられたデータを解放するために使用されるコールバック関数へのポインターです。このメンバーは省略可能で、NULL を指定できます。 |
| pfnAuthFailed | PFNPEER_ON_PASSWORD_AUTH_FAILED | 8/4 | +72 | +36 | パスワード認証失敗時に呼ばれるコールバック関数ポインタ。 |
公式ドキュメント
PEER_SECURITY_INTERFACE 構造体は、Peer Graphing API の呼び出しがレコードの検証、セキュリティ保護、および解放に使用するセキュリティインターフェイスを指定します。さらに、セキュリティサービスプロバイダー (SSP) の実装を含む .DLL のパスをアプリケーションが指定できるようにします。
解説(Remarks)
独自の SSP を開発した場合、アプリケーションはグラフデータベース内のデータにアクセスするために Peer Graphing API を呼び出してはなりません。呼び出すとデッドロックが発生する可能性があります。代わりに、アプリケーションはキャッシュされた情報のコピーを参照するようにしてください。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PEER_SECURITY_INTERFACE (x64 80 / x86 40 バイト)
typedef struct PEER_SECURITY_INTERFACE {
DWORD dwSize;
LPWSTR pwzSspFilename;
LPWSTR pwzPackageName;
DWORD cbSecurityInfo;
BYTE* pbSecurityInfo;
void* pvContext;
PFNPEER_VALIDATE_RECORD pfnValidateRecord;
PFNPEER_SECURE_RECORD pfnSecureRecord;
PFNPEER_FREE_SECURITY_DATA pfnFreeSecurityData;
PFNPEER_ON_PASSWORD_AUTH_FAILED pfnAuthFailed;
} PEER_SECURITY_INTERFACE;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PEER_SECURITY_INTERFACE
{
public uint dwSize;
public IntPtr pwzSspFilename;
public IntPtr pwzPackageName;
public uint cbSecurityInfo;
public IntPtr pbSecurityInfo;
public IntPtr pvContext;
public IntPtr pfnValidateRecord;
public IntPtr pfnSecureRecord;
public IntPtr pfnFreeSecurityData;
public IntPtr pfnAuthFailed;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PEER_SECURITY_INTERFACE
Public dwSize As UInteger
Public pwzSspFilename As IntPtr
Public pwzPackageName As IntPtr
Public cbSecurityInfo As UInteger
Public pbSecurityInfo As IntPtr
Public pvContext As IntPtr
Public pfnValidateRecord As IntPtr
Public pfnSecureRecord As IntPtr
Public pfnFreeSecurityData As IntPtr
Public pfnAuthFailed As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class PEER_SECURITY_INTERFACE(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("pwzSspFilename", ctypes.c_void_p),
("pwzPackageName", ctypes.c_void_p),
("cbSecurityInfo", wintypes.DWORD),
("pbSecurityInfo", ctypes.c_void_p),
("pvContext", ctypes.c_void_p),
("pfnValidateRecord", ctypes.c_void_p),
("pfnSecureRecord", ctypes.c_void_p),
("pfnFreeSecurityData", ctypes.c_void_p),
("pfnAuthFailed", ctypes.c_void_p),
]#[repr(C)]
pub struct PEER_SECURITY_INTERFACE {
pub dwSize: u32,
pub pwzSspFilename: *mut core::ffi::c_void,
pub pwzPackageName: *mut core::ffi::c_void,
pub cbSecurityInfo: u32,
pub pbSecurityInfo: *mut core::ffi::c_void,
pub pvContext: *mut core::ffi::c_void,
pub pfnValidateRecord: *mut core::ffi::c_void,
pub pfnSecureRecord: *mut core::ffi::c_void,
pub pfnFreeSecurityData: *mut core::ffi::c_void,
pub pfnAuthFailed: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type PEER_SECURITY_INTERFACE struct {
dwSize uint32
pwzSspFilename uintptr
pwzPackageName uintptr
cbSecurityInfo uint32
pbSecurityInfo uintptr
pvContext uintptr
pfnValidateRecord uintptr
pfnSecureRecord uintptr
pfnFreeSecurityData uintptr
pfnAuthFailed uintptr
}type
PEER_SECURITY_INTERFACE = record
dwSize: DWORD;
pwzSspFilename: Pointer;
pwzPackageName: Pointer;
cbSecurityInfo: DWORD;
pbSecurityInfo: Pointer;
pvContext: Pointer;
pfnValidateRecord: Pointer;
pfnSecureRecord: Pointer;
pfnFreeSecurityData: Pointer;
pfnAuthFailed: Pointer;
end;const PEER_SECURITY_INTERFACE = extern struct {
dwSize: u32,
pwzSspFilename: ?*anyopaque,
pwzPackageName: ?*anyopaque,
cbSecurityInfo: u32,
pbSecurityInfo: ?*anyopaque,
pvContext: ?*anyopaque,
pfnValidateRecord: ?*anyopaque,
pfnSecureRecord: ?*anyopaque,
pfnFreeSecurityData: ?*anyopaque,
pfnAuthFailed: ?*anyopaque,
};type
PEER_SECURITY_INTERFACE {.bycopy.} = object
dwSize: uint32
pwzSspFilename: pointer
pwzPackageName: pointer
cbSecurityInfo: uint32
pbSecurityInfo: pointer
pvContext: pointer
pfnValidateRecord: pointer
pfnSecureRecord: pointer
pfnFreeSecurityData: pointer
pfnAuthFailed: pointerstruct PEER_SECURITY_INTERFACE
{
uint dwSize;
void* pwzSspFilename;
void* pwzPackageName;
uint cbSecurityInfo;
void* pbSecurityInfo;
void* pvContext;
void* pfnValidateRecord;
void* pfnSecureRecord;
void* pfnFreeSecurityData;
void* pfnAuthFailed;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; PEER_SECURITY_INTERFACE サイズ: 40 バイト(x86)
dim st, 10 ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pwzSspFilename : LPWSTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; pwzPackageName : LPWSTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; cbSecurityInfo : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; pbSecurityInfo : BYTE* (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; pvContext : void* (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; pfnValidateRecord : PFNPEER_VALIDATE_RECORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pfnSecureRecord : PFNPEER_SECURE_RECORD (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; pfnFreeSecurityData : PFNPEER_FREE_SECURITY_DATA (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; pfnAuthFailed : PFNPEER_ON_PASSWORD_AUTH_FAILED (+36, 4byte) st.9 = 値 / 値 = st.9 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PEER_SECURITY_INTERFACE サイズ: 80 バイト(x64)
dim st, 20 ; 4byte整数×20(構造体サイズ 80 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; pwzSspFilename : LPWSTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pwzPackageName : LPWSTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; cbSecurityInfo : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; pbSecurityInfo : BYTE* (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; pvContext : void* (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; pfnValidateRecord : PFNPEER_VALIDATE_RECORD (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; pfnSecureRecord : PFNPEER_SECURE_RECORD (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; pfnFreeSecurityData : PFNPEER_FREE_SECURITY_DATA (+64, 8byte) qpoke st,64,値 / qpeek(st,64) ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; pfnAuthFailed : PFNPEER_ON_PASSWORD_AUTH_FAILED (+72, 8byte) qpoke st,72,値 / qpeek(st,72) ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PEER_SECURITY_INTERFACE
#field int dwSize
#field intptr pwzSspFilename
#field intptr pwzPackageName
#field int cbSecurityInfo
#field intptr pbSecurityInfo
#field intptr pvContext
#field intptr pfnValidateRecord
#field intptr pfnSecureRecord
#field intptr pfnFreeSecurityData
#field intptr pfnAuthFailed
#endstruct
stdim st, PEER_SECURITY_INTERFACE ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize