Win32 API 日本語リファレンス
ホームNetworking.WinSock › WSCSetProviderInfo32

WSCSetProviderInfo32

関数
32ビットカタログのプロバイダ情報を設定する。
DLLWS2_32.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

// WS2_32.dll
#include <windows.h>

INT WSCSetProviderInfo32(
    GUID* lpProviderId,
    WSC_PROVIDER_INFO_TYPE InfoType,
    BYTE* Info,
    UINT_PTR InfoSize,
    DWORD Flags,
    INT* lpErrno
);

パラメーター

名前方向説明
lpProviderIdGUID*inプロバイダーのグローバル一意識別子 (GUID) へのポインターです。
InfoTypeWSC_PROVIDER_INFO_TYPEinこの LSP プロトコルエントリに対して設定する情報クラスです。
InfoBYTE*inLSP プロトコルエントリに設定する情報クラスのデータを格納したバッファーへのポインターです。
InfoSizeUINT_PTRinInfo パラメーターが指すバッファーのサイズ (バイト単位) です。
FlagsDWORDinWSCSetProviderInfo32 関数呼び出しの動作を変更するために使用するフラグです。
lpErrnoINT*out関数が失敗した場合のエラーコードへのポインターです。

戻り値の型: INT

公式ドキュメント

レイヤードサービスプロバイダー (LSP) に対して、指定した情報クラスのデータ値を設定します。

戻り値

エラーが発生しなかった場合、WSCSetProviderInfo32ERROR_SUCCESS (ゼロ) を返します。それ以外の場合は SOCKET_ERROR を返し、lpErrno パラメーターに特定のエラーコードが返されます。

エラーコード 意味
ERROR_CALL_NOT_IMPLEMENTED
呼び出しが実装されていません。このエラーは、InfoType パラメーターに **ProviderInfoAudit** が指定された場合に返されます。
WSAEFAULT
1 つ以上の引数が、ユーザーアドレス空間の有効な領域内にありません。
WSAEINVAL
1 つ以上の引数が無効です。
WSANO_RECOVERY
回復不能なエラーが発生しました。このエラーは、ユーザーが Winsock レジストリへの書き込みに必要な管理者権限を持っていない場合や、Winsock カタログエントリを開く際に失敗が発生した場合など、いくつかの条件で返されます。
WSA_NOT_ENOUGH_MEMORY
利用可能なメモリが不足しています。このエラーは、新しいカタログエントリを割り当てるためのメモリが不足している場合に返されます。

解説(Remarks)

WSCSetProviderInfo32 は、WSCSetProviderInfo の厳密な 32 ビット版です。64 ビットコンピューター上では、特に 32 ビット用ではないすべての呼び出し (たとえば末尾が "32" で終わらないすべての関数) は、ネイティブの 64 ビットカタログに対して動作します。64 ビットコンピューター上で実行されるプロセスは、厳密に 32 ビットのカタログに対して動作し互換性を維持するために、専用の 32 ビット関数呼び出しを使用する必要があります。専用の 32 ビット呼び出しの定義とセマンティクスは、対応するネイティブ版と同じです。

WSCSetProviderInfo32 は、32 ビットのレイヤードサービスプロバイダーに対して情報クラスのデータを設定するために使用されます。InfoType パラメーターが ProviderInfoLspCategories に設定されている場合、成功すると WSCSetProviderInfo32 は、Info パラメーターで渡された値に基づいて、プロバイダーが実装する適切な LSP カテゴリフラグを設定します。

Winsock 2 はレイヤードプロトコルに対応しています。レイヤードプロトコルとは、より高レベルの通信機能のみを実装し、リモートエンドポイントとの実際のデータ交換については下位のトランスポートスタックに依存するプロトコルです。レイヤードプロトコルまたはレイヤードサービスプロバイダーの例としては、認証を実行し、相互に合意した暗号化方式を確立するために、接続確立プロセスにプロトコルを追加するセキュリティ層が挙げられます。 このようなセキュリティプロトコルは、一般に TCP や SPX のような下位の信頼性の高いトランスポートプロトコルのサービスを必要とします。 ベースプロトコルという用語は、TCP や SPX のように、リモートエンドポイントとのデータ通信を実行できるプロトコルを指します。レイヤードプロトコルという用語は、単独では成り立たないプロトコルを表すために使用されます。 そして、プロトコルチェーンは、1 つ以上のレイヤードプロトコルが連結され、ベースプロトコルによって固定されたものとして定義されます。 ベースプロトコルでは、WSAProtocol_Info 構造体の ChainLen メンバーが、1 として定義されている BASE_PROTOCOL に設定されます。レイヤードプロトコルでは、WSAPROTOCOL_INFO 構造体の ChainLen メンバーが、ゼロとして定義されている LAYERED_PROTOCOL に設定されます。プロトコルチェーンでは、WSAPROTOCOL_INFO 構造体の ChainLen メンバーが 1 より大きい値に設定されます。

LSP の初期化中に、LSP は多数の Winsock SPI 関数へのポインターを提供する必要があります。 これらの関数は、通常の処理中に LSP の直上の層 (別の LSP または Ws2_32.dll) によって呼び出されます。

インストール可能ファイルシステム (IFS) を実装する LSP は、自身が実装する関数へのポインターを提供するか、LSP の直下の層が提供するポインターをそのまま返すかを選択できます。 非 IFS LSP は、独自のハンドルを提供するため、すべての Winsock SPI 関数を実装する必要があります。 これは、各 SPI において、LSP が作成したすべてのソケットハンドルを下位プロバイダー (別の LSP またはベースプロトコル) のソケットハンドルにマッピングする必要があるためです。

ただし、すべての LSP は、Winsock SPI 関数のサブセットに対してのみ追加処理を行うことで、それぞれ固有の処理を実行します。

LSP が実装する SPI 関数のサブセットと、それらの関数ごとに実行される追加処理の性質に基づいて、LSP のカテゴリを定義できます。

LSP を分類し、また Winsock ソケットを使用するアプリケーションを分類することで、実行時に特定のプロセスに LSP を関与させるべきかどうかを選択的に判断できるようになります。

Windows Vista 以降では、LSP を Windows ソケットの呼び出しおよびデータとどのように相互作用するかに基づいて分類できます。LSP カテゴリとは、Winsock SPI 関数のサブセットにおける、識別可能な動作のグループです。 たとえば、HTTP コンテンツフィルターはデータインスペクター (LSP_INSPECTOR カテゴリ) に分類されます。LSP_INSPECTOR カテゴリは、データ転送 SPI 関数のパラメーターを検査しますが、変更はしません。アプリケーションは LSP のカテゴリを問い合わせ、その LSP カテゴリと、アプリケーションが許可する LSP カテゴリのセットに基づいて、その LSP を読み込まないことを選択できます。

次の表は、LSP を分類できるカテゴリの一覧です。

LSP カテゴリ 説明
**LSP_CRYPTO_COMPRESS** LSP は暗号化またはデータ圧縮のプロバイダーです。
**LSP_FIREWALL** LSP はファイアウォールのプロバイダーです。
**LSP_LOCAL_CACHE** LSP はローカルキャッシュのプロバイダーです。
**LSP_INBOUND_MODIFY** LSP は受信データを変更します。
**LSP_INSPECTOR** LSP はデータを検査またはフィルタリングします。
**LSP_OUTBOUND_MODIFY** LSP は送信データを変更します。
**LSP_PROXY** LSP はプロキシとして動作し、パケットをリダイレクトします。
**LSP_REDIRECTOR** LSP はネットワークリダイレクターです。
**LSP_SYSTEM** LSP はサービスおよびシステムプロセスでの使用に適しています。

1 つの LSP が複数のカテゴリに属することもあります。 たとえば、ファイアウォール/セキュリティ LSP は、インスペクター (LSP_INSPECTOR) とファイアウォール (LSP_FIREWALL) の両方のカテゴリに属することができます。

LSP にカテゴリが設定されていない場合、その LSP は「その他すべて」カテゴリに属するものとみなされます。この LSP カテゴリは、サービスやシステムプロセス (たとえば lsass、winlogon、多くの svchost プロセス) では読み込まれません。

WSCSetProviderInfo32 関数は、Administrators グループのメンバーとしてログオンしているユーザーのみが呼び出すことができます。Administrators グループのメンバーではないユーザーが WSCSetProviderInfo32 を呼び出した場合、関数呼び出しは失敗し、lpErrno パラメーターに WSANO_RECOVERY が返されます。 この関数は、ユーザーアカウント制御 (UAC) が原因で失敗することもあります。この関数を含むアプリケーションが、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーによって実行された場合、アプリケーションのマニフェストファイルで requestedExecutionLevelrequireAdministrator に設定されていない限り、この呼び出しは失敗します。Windows Vista または Windows Server 2008 上のアプリケーションにこのマニフェストファイルがない場合、組み込みの Administrator 以外の Administrators グループのメンバーとしてログオンしているユーザーは、この関数を成功させるために、組み込みの Administrator として拡張シェル内 (管理者として実行) でアプリケーションを実行している必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

// WS2_32.dll
#include <windows.h>

INT WSCSetProviderInfo32(
    GUID* lpProviderId,
    WSC_PROVIDER_INFO_TYPE InfoType,
    BYTE* Info,
    UINT_PTR InfoSize,
    DWORD Flags,
    INT* lpErrno
);
[DllImport("WS2_32.dll", ExactSpelling = true)]
static extern int WSCSetProviderInfo32(
    ref Guid lpProviderId,   // GUID*
    int InfoType,   // WSC_PROVIDER_INFO_TYPE
    IntPtr Info,   // BYTE*
    UIntPtr InfoSize,   // UINT_PTR
    uint Flags,   // DWORD
    out int lpErrno   // INT* out
);
<DllImport("WS2_32.dll", ExactSpelling:=True)>
Public Shared Function WSCSetProviderInfo32(
    ByRef lpProviderId As Guid,   ' GUID*
    InfoType As Integer,   ' WSC_PROVIDER_INFO_TYPE
    Info As IntPtr,   ' BYTE*
    InfoSize As UIntPtr,   ' UINT_PTR
    Flags As UInteger,   ' DWORD
    <Out> ByRef lpErrno As Integer   ' INT* out
) As Integer
End Function
' lpProviderId : GUID*
' InfoType : WSC_PROVIDER_INFO_TYPE
' Info : BYTE*
' InfoSize : UINT_PTR
' Flags : DWORD
' lpErrno : INT* out
Declare PtrSafe Function WSCSetProviderInfo32 Lib "ws2_32" ( _
    ByVal lpProviderId As LongPtr, _
    ByVal InfoType As Long, _
    ByVal Info As LongPtr, _
    ByVal InfoSize As LongPtr, _
    ByVal Flags As Long, _
    ByRef lpErrno As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

WSCSetProviderInfo32 = ctypes.windll.ws2_32.WSCSetProviderInfo32
WSCSetProviderInfo32.restype = ctypes.c_int
WSCSetProviderInfo32.argtypes = [
    ctypes.c_void_p,  # lpProviderId : GUID*
    ctypes.c_int,  # InfoType : WSC_PROVIDER_INFO_TYPE
    ctypes.POINTER(ctypes.c_ubyte),  # Info : BYTE*
    ctypes.c_size_t,  # InfoSize : UINT_PTR
    wintypes.DWORD,  # Flags : DWORD
    ctypes.POINTER(ctypes.c_int),  # lpErrno : INT* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('WS2_32.dll')
WSCSetProviderInfo32 = Fiddle::Function.new(
  lib['WSCSetProviderInfo32'],
  [
    Fiddle::TYPE_VOIDP,  # lpProviderId : GUID*
    Fiddle::TYPE_INT,  # InfoType : WSC_PROVIDER_INFO_TYPE
    Fiddle::TYPE_VOIDP,  # Info : BYTE*
    Fiddle::TYPE_UINTPTR_T,  # InfoSize : UINT_PTR
    -Fiddle::TYPE_INT,  # Flags : DWORD
    Fiddle::TYPE_VOIDP,  # lpErrno : INT* out
  ],
  Fiddle::TYPE_INT)
#[link(name = "ws2_32")]
extern "system" {
    fn WSCSetProviderInfo32(
        lpProviderId: *mut GUID,  // GUID*
        InfoType: i32,  // WSC_PROVIDER_INFO_TYPE
        Info: *mut u8,  // BYTE*
        InfoSize: usize,  // UINT_PTR
        Flags: u32,  // DWORD
        lpErrno: *mut i32  // INT* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("WS2_32.dll")]
public static extern int WSCSetProviderInfo32(ref Guid lpProviderId, int InfoType, IntPtr Info, UIntPtr InfoSize, uint Flags, out int lpErrno);
"@
$api = Add-Type -MemberDefinition $sig -Name 'WS2_32_WSCSetProviderInfo32' -Namespace Win32 -PassThru
# $api::WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
#uselib "WS2_32.dll"
#func global WSCSetProviderInfo32 "WSCSetProviderInfo32" sptr, sptr, sptr, sptr, sptr, sptr
; WSCSetProviderInfo32 varptr(lpProviderId), InfoType, varptr(Info), InfoSize, Flags, varptr(lpErrno)   ; 戻り値は stat
; lpProviderId : GUID* -> "sptr"
; InfoType : WSC_PROVIDER_INFO_TYPE -> "sptr"
; Info : BYTE* -> "sptr"
; InfoSize : UINT_PTR -> "sptr"
; Flags : DWORD -> "sptr"
; lpErrno : INT* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "WS2_32.dll"
#cfunc global WSCSetProviderInfo32 "WSCSetProviderInfo32" var, int, var, sptr, int, var
; res = WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
; lpProviderId : GUID* -> "var"
; InfoType : WSC_PROVIDER_INFO_TYPE -> "int"
; Info : BYTE* -> "var"
; InfoSize : UINT_PTR -> "sptr"
; Flags : DWORD -> "int"
; lpErrno : INT* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; INT WSCSetProviderInfo32(GUID* lpProviderId, WSC_PROVIDER_INFO_TYPE InfoType, BYTE* Info, UINT_PTR InfoSize, DWORD Flags, INT* lpErrno)
#uselib "WS2_32.dll"
#cfunc global WSCSetProviderInfo32 "WSCSetProviderInfo32" var, int, var, intptr, int, var
; res = WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
; lpProviderId : GUID* -> "var"
; InfoType : WSC_PROVIDER_INFO_TYPE -> "int"
; Info : BYTE* -> "var"
; InfoSize : UINT_PTR -> "intptr"
; Flags : DWORD -> "int"
; lpErrno : INT* out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	ws2_32 = windows.NewLazySystemDLL("WS2_32.dll")
	procWSCSetProviderInfo32 = ws2_32.NewProc("WSCSetProviderInfo32")
)

// lpProviderId (GUID*), InfoType (WSC_PROVIDER_INFO_TYPE), Info (BYTE*), InfoSize (UINT_PTR), Flags (DWORD), lpErrno (INT* out)
r1, _, err := procWSCSetProviderInfo32.Call(
	uintptr(lpProviderId),
	uintptr(InfoType),
	uintptr(Info),
	uintptr(InfoSize),
	uintptr(Flags),
	uintptr(lpErrno),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // INT
function WSCSetProviderInfo32(
  lpProviderId: PGUID;   // GUID*
  InfoType: Integer;   // WSC_PROVIDER_INFO_TYPE
  Info: Pointer;   // BYTE*
  InfoSize: NativeUInt;   // UINT_PTR
  Flags: DWORD;   // DWORD
  lpErrno: Pointer   // INT* out
): Integer; stdcall;
  external 'WS2_32.dll' name 'WSCSetProviderInfo32';
result := DllCall("WS2_32\WSCSetProviderInfo32"
    , "Ptr", lpProviderId   ; GUID*
    , "Int", InfoType   ; WSC_PROVIDER_INFO_TYPE
    , "Ptr", Info   ; BYTE*
    , "UPtr", InfoSize   ; UINT_PTR
    , "UInt", Flags   ; DWORD
    , "Ptr", lpErrno   ; INT* out
    , "Int")   ; return: INT
●WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno) = DLL("WS2_32.dll", "int WSCSetProviderInfo32(void*, int, void*, int, dword, void*)")
# 呼び出し: WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
# lpProviderId : GUID* -> "void*"
# InfoType : WSC_PROVIDER_INFO_TYPE -> "int"
# Info : BYTE* -> "void*"
# InfoSize : UINT_PTR -> "int"
# Flags : DWORD -> "dword"
# lpErrno : INT* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "ws2_32" fn WSCSetProviderInfo32(
    lpProviderId: [*c]GUID, // GUID*
    InfoType: i32, // WSC_PROVIDER_INFO_TYPE
    Info: [*c]u8, // BYTE*
    InfoSize: usize, // UINT_PTR
    Flags: u32, // DWORD
    lpErrno: [*c]i32 // INT* out
) callconv(std.os.windows.WINAPI) i32;
proc WSCSetProviderInfo32(
    lpProviderId: ptr GUID,  # GUID*
    InfoType: int32,  # WSC_PROVIDER_INFO_TYPE
    Info: ptr uint8,  # BYTE*
    InfoSize: uint,  # UINT_PTR
    Flags: uint32,  # DWORD
    lpErrno: ptr int32  # INT* out
): int32 {.importc: "WSCSetProviderInfo32", stdcall, dynlib: "WS2_32.dll".}
pragma(lib, "ws2_32");
extern(Windows)
int WSCSetProviderInfo32(
    GUID* lpProviderId,   // GUID*
    int InfoType,   // WSC_PROVIDER_INFO_TYPE
    ubyte* Info,   // BYTE*
    size_t InfoSize,   // UINT_PTR
    uint Flags,   // DWORD
    int* lpErrno   // INT* out
);
ccall((:WSCSetProviderInfo32, "WS2_32.dll"), stdcall, Int32,
      (Ptr{GUID}, Int32, Ptr{UInt8}, Csize_t, UInt32, Ptr{Int32}),
      lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
# lpProviderId : GUID* -> Ptr{GUID}
# InfoType : WSC_PROVIDER_INFO_TYPE -> Int32
# Info : BYTE* -> Ptr{UInt8}
# InfoSize : UINT_PTR -> Csize_t
# Flags : DWORD -> UInt32
# lpErrno : INT* out -> Ptr{Int32}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int32_t WSCSetProviderInfo32(
    void* lpProviderId,
    int32_t InfoType,
    uint8_t* Info,
    uintptr_t InfoSize,
    uint32_t Flags,
    int32_t* lpErrno);
]]
local ws2_32 = ffi.load("ws2_32")
-- ws2_32.WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
-- lpProviderId : GUID*
-- InfoType : WSC_PROVIDER_INFO_TYPE
-- Info : BYTE*
-- InfoSize : UINT_PTR
-- Flags : DWORD
-- lpErrno : INT* out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('WS2_32.dll');
const WSCSetProviderInfo32 = lib.func('__stdcall', 'WSCSetProviderInfo32', 'int32_t', ['void *', 'int32_t', 'uint8_t *', 'uintptr_t', 'uint32_t', 'int32_t *']);
// WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
// lpProviderId : GUID* -> 'void *'
// InfoType : WSC_PROVIDER_INFO_TYPE -> 'int32_t'
// Info : BYTE* -> 'uint8_t *'
// InfoSize : UINT_PTR -> 'uintptr_t'
// Flags : DWORD -> 'uint32_t'
// lpErrno : INT* out -> 'int32_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("WS2_32.dll", {
  WSCSetProviderInfo32: { parameters: ["pointer", "i32", "pointer", "usize", "u32", "pointer"], result: "i32" },
});
// lib.symbols.WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno)
// lpProviderId : GUID* -> "pointer"
// InfoType : WSC_PROVIDER_INFO_TYPE -> "i32"
// Info : BYTE* -> "pointer"
// InfoSize : UINT_PTR -> "usize"
// Flags : DWORD -> "u32"
// lpErrno : INT* out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int32_t WSCSetProviderInfo32(
    void* lpProviderId,
    int32_t InfoType,
    uint8_t* Info,
    size_t InfoSize,
    uint32_t Flags,
    int32_t* lpErrno);
C, "WS2_32.dll");
// $ffi->WSCSetProviderInfo32(lpProviderId, InfoType, Info, InfoSize, Flags, lpErrno);
// lpProviderId : GUID*
// InfoType : WSC_PROVIDER_INFO_TYPE
// Info : BYTE*
// InfoSize : UINT_PTR
// Flags : DWORD
// lpErrno : INT* out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。
import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Ws2_32 extends StdCallLibrary {
    Ws2_32 INSTANCE = Native.load("ws2_32", Ws2_32.class);
    int WSCSetProviderInfo32(
        Pointer lpProviderId,   // GUID*
        int InfoType,   // WSC_PROVIDER_INFO_TYPE
        byte[] Info,   // BYTE*
        long InfoSize,   // UINT_PTR
        int Flags,   // DWORD
        IntByReference lpErrno   // INT* out
    );
}
@[Link("ws2_32")]
lib LibWS2_32
  fun WSCSetProviderInfo32 = WSCSetProviderInfo32(
    lpProviderId : GUID*,   # GUID*
    InfoType : Int32,   # WSC_PROVIDER_INFO_TYPE
    Info : UInt8*,   # BYTE*
    InfoSize : LibC::SizeT,   # UINT_PTR
    Flags : UInt32,   # DWORD
    lpErrno : Int32*   # INT* out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef WSCSetProviderInfo32Native = Int32 Function(Pointer<Void>, Int32, Pointer<Uint8>, UintPtr, Uint32, Pointer<Int32>);
typedef WSCSetProviderInfo32Dart = int Function(Pointer<Void>, int, Pointer<Uint8>, int, int, Pointer<Int32>);
final WSCSetProviderInfo32 = DynamicLibrary.open('WS2_32.dll')
    .lookupFunction<WSCSetProviderInfo32Native, WSCSetProviderInfo32Dart>('WSCSetProviderInfo32');
// lpProviderId : GUID* -> Pointer<Void>
// InfoType : WSC_PROVIDER_INFO_TYPE -> Int32
// Info : BYTE* -> Pointer<Uint8>
// InfoSize : UINT_PTR -> UintPtr
// Flags : DWORD -> Uint32
// lpErrno : INT* out -> Pointer<Int32>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function WSCSetProviderInfo32(
  lpProviderId: PGUID;   // GUID*
  InfoType: Integer;   // WSC_PROVIDER_INFO_TYPE
  Info: Pointer;   // BYTE*
  InfoSize: NativeUInt;   // UINT_PTR
  Flags: DWORD;   // DWORD
  lpErrno: Pointer   // INT* out
): Integer; stdcall;
  external 'WS2_32.dll' name 'WSCSetProviderInfo32';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "WSCSetProviderInfo32"
  c_WSCSetProviderInfo32 :: Ptr () -> Int32 -> Ptr Word8 -> CUIntPtr -> Word32 -> Ptr Int32 -> IO Int32
-- lpProviderId : GUID* -> Ptr ()
-- InfoType : WSC_PROVIDER_INFO_TYPE -> Int32
-- Info : BYTE* -> Ptr Word8
-- InfoSize : UINT_PTR -> CUIntPtr
-- Flags : DWORD -> Word32
-- lpErrno : INT* out -> Ptr Int32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let wscsetproviderinfo32 =
  foreign "WSCSetProviderInfo32"
    ((ptr void) @-> int32_t @-> (ptr uint8_t) @-> size_t @-> uint32_t @-> (ptr int32_t) @-> returning int32_t)
(* lpProviderId : GUID* -> (ptr void) *)
(* InfoType : WSC_PROVIDER_INFO_TYPE -> int32_t *)
(* Info : BYTE* -> (ptr uint8_t) *)
(* InfoSize : UINT_PTR -> size_t *)
(* Flags : DWORD -> uint32_t *)
(* lpErrno : INT* out -> (ptr int32_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library ws2_32 (t "WS2_32.dll"))
(cffi:use-foreign-library ws2_32)

(cffi:defcfun ("WSCSetProviderInfo32" wscset-provider-info32 :convention :stdcall) :int32
  (lp-provider-id :pointer)   ; GUID*
  (info-type :int32)   ; WSC_PROVIDER_INFO_TYPE
  (info :pointer)   ; BYTE*
  (info-size :uint64)   ; UINT_PTR
  (flags :uint32)   ; DWORD
  (lp-errno :pointer))   ; INT* out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $WSCSetProviderInfo32 = Win32::API::More->new('WS2_32',
    'int WSCSetProviderInfo32(LPVOID lpProviderId, int InfoType, LPVOID Info, WPARAM InfoSize, DWORD Flags, LPVOID lpErrno)');
# my $ret = $WSCSetProviderInfo32->Call($lpProviderId, $InfoType, $Info, $InfoSize, $Flags, $lpErrno);
# lpProviderId : GUID* -> LPVOID
# InfoType : WSC_PROVIDER_INFO_TYPE -> int
# Info : BYTE* -> LPVOID
# InfoSize : UINT_PTR -> WPARAM
# Flags : DWORD -> DWORD
# lpErrno : INT* out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

関連項目

類似 API
公式の関連項目
使用する型