ホーム › Security.Cryptography › BCryptResolveProviders

BCryptResolveProviders

関数

条件に合致するCNG暗号プロバイダーを解決して一覧を取得する。

DLLbcrypt.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

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

NTSTATUS BCryptResolveProviders(
    LPCWSTR pszContext,   // optional
    DWORD dwInterface,   // optional
    LPCWSTR pszFunction,   // optional
    LPCWSTR pszProvider,   // optional
    BCRYPT_QUERY_PROVIDER_MODE dwMode,
    BCRYPT_RESOLVE_PROVIDERS_FLAGS dwFlags,
    DWORD* pcbBuffer,
    CRYPT_PROVIDER_REFS** ppBuffer   // optional
);

パラメーター

名前

型

方向

説明

pszContext

LPCWSTR

inoptional

プロバイダーを取得する対象のコンテキストの識別子を含む、null で終わる Unicode 文字列へのポインターです。これが NULL または空文字列に設定されている場合、既定のコンテキストが使用されます。

dwInterface

DWORD

inoptional

プロバイダーがサポートしている必要があるインターフェイスの識別子です。これは CNG Interface Identifiers のいずれかである必要があります。pszFunction パラメーターが NULL または空文字列でない場合は、dwInterface をゼロに設定して、関数にインターフェイスを推測させることができます。

pszFunction

LPCWSTR

inoptional

プロバイダーがサポートしている必要があるアルゴリズムまたは関数の識別子を含む、null で終わる Unicode 文字列へのポインターです。これは、標準の CNG Algorithm Identifiers のいずれか、または登録済みの別のアルゴリズムの識別子を指定できます。dwInterface がゼロ以外の値に設定されている場合は、pszFunction を NULL にして、すべてのアルゴリズムと関数を含めることができます。

pszProvider

LPCWSTR

inoptional

取得するプロバイダーの名前を含む、null で終わる Unicode 文字列へのポインターです。このパラメーターが NULL の場合、すべてのプロバイダーが含まれます。

このパラメーターを使用すると、その他の条件を満たすプロバイダーが複数存在する場合に、取得する特定のプロバイダーを指定できます。

dwMode

BCRYPT_QUERY_PROVIDER_MODE

取得するプロバイダーの種類を指定します。これは次のいずれかの値を指定できます。

値	意味
CRYPT_UM	ユーザーモードのプロバイダーを取得します。
CRYPT_KM	カーネルモードのプロバイダーを取得します。
CRYPT_MM	ユーザーモードとカーネルモードの両方のプロバイダーを取得します。

dwFlags

BCRYPT_RESOLVE_PROVIDERS_FLAGS

この関数の動作を変更する一連のフラグです。

これはゼロ、または次の値の 1 つ以上の組み合わせを指定できます。

値	意味
CRYPT_ALL_FUNCTIONS 1	この関数は、指定された条件を満たす各プロバイダーがサポートするすべての関数を取得します。このフラグが指定されていない場合、この関数は、指定された条件を満たすプロバイダーの最初の関数のみを取得します。
CRYPT_ALL_PROVIDERS 2	この関数は、指定された条件を満たすすべてのプロバイダーを取得します。このフラグが指定されていない場合、この関数は、指定された条件を満たす最初に見つかったプロバイダーのみを取得します。

pcbBuffer

DWORD*

inout

DWORD 値へのポインターです。入力時には、ppBuffer パラメーターが指すバッファーのサイズ (バイト単位) を格納します。出力時には、この値にバッファーにコピーされたバイト数、または必要なバッファーのサイズ (バイト単位) のいずれかが格納されます。

ppBuffer

CRYPT_PROVIDER_REFS**

outoptional

指定された条件を満たすプロバイダーのコレクションを受け取る CRYPT_PROVIDER_REFS ポインターのアドレスです。

このパラメーターが NULL の場合、この関数は STATUS_SUCCESS を返し、pcbBuffer パラメーターが指す値に、すべてのデータに必要なサイズ (バイト単位) を格納します。

このパラメーターが NULL ポインターのアドレスである場合、この関数は必要なメモリを割り当て、そのメモリにプロバイダーに関する情報を格納し、このメモリへのポインターをこのパラメーターに格納します。このメモリの使用が終わったら、このポインターを BCryptFreeBuffer 関数に渡して解放してください。

このパラメーターが非 NULL ポインターのアドレスである場合、この関数はプロバイダー情報をこのバッファーにコピーします。pcbBuffer パラメーターには、バッファー全体のサイズ (バイト単位) を格納する必要があります。バッファーがすべてのプロバイダー情報を保持するのに十分な大きさでない場合、この関数は STATUS_BUFFER_TOO_SMALL を返します。

戻り値の型: NTSTATUS

公式ドキュメント

指定された条件を満たすすべてのプロバイダーのコレクションを取得します。

戻り値

関数の成功または失敗を示すステータスコードを返します。

返される可能性のあるコードには、次のものが含まれますが、これらに限定されません。

戻り値	説明
STATUS_SUCCESS	関数は成功しました。
STATUS_BUFFER_TOO_SMALL	pcbBuffer パラメーターで指定されたサイズが、すべてのデータを保持するのに十分な大きさではありません。
STATUS_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
STATUS_NOT_FOUND	指定されたすべての条件を満たすプロバイダーが見つかりませんでした。

解説(Remarks)

BCryptResolveProviders は、ユーザーモードまたはカーネルモードのいずれからでも呼び出すことができます。カーネルモードの呼び出し元は、PASSIVE_LEVEL IRQL で実行されている必要があります。

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

各言語での呼び出し定義

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

NTSTATUS BCryptResolveProviders(
    LPCWSTR pszContext,   // optional
    DWORD dwInterface,   // optional
    LPCWSTR pszFunction,   // optional
    LPCWSTR pszProvider,   // optional
    BCRYPT_QUERY_PROVIDER_MODE dwMode,
    BCRYPT_RESOLVE_PROVIDERS_FLAGS dwFlags,
    DWORD* pcbBuffer,
    CRYPT_PROVIDER_REFS** ppBuffer   // optional
);

[DllImport("bcrypt.dll", ExactSpelling = true)]
static extern int BCryptResolveProviders(
    [MarshalAs(UnmanagedType.LPWStr)] string pszContext,   // LPCWSTR optional
    uint dwInterface,   // DWORD optional
    [MarshalAs(UnmanagedType.LPWStr)] string pszFunction,   // LPCWSTR optional
    [MarshalAs(UnmanagedType.LPWStr)] string pszProvider,   // LPCWSTR optional
    uint dwMode,   // BCRYPT_QUERY_PROVIDER_MODE
    uint dwFlags,   // BCRYPT_RESOLVE_PROVIDERS_FLAGS
    ref uint pcbBuffer,   // DWORD* in/out
    IntPtr ppBuffer   // CRYPT_PROVIDER_REFS** optional, out
);

<DllImport("bcrypt.dll", ExactSpelling:=True)>
Public Shared Function BCryptResolveProviders(
    <MarshalAs(UnmanagedType.LPWStr)> pszContext As String,   ' LPCWSTR optional
    dwInterface As UInteger,   ' DWORD optional
    <MarshalAs(UnmanagedType.LPWStr)> pszFunction As String,   ' LPCWSTR optional
    <MarshalAs(UnmanagedType.LPWStr)> pszProvider As String,   ' LPCWSTR optional
    dwMode As UInteger,   ' BCRYPT_QUERY_PROVIDER_MODE
    dwFlags As UInteger,   ' BCRYPT_RESOLVE_PROVIDERS_FLAGS
    ByRef pcbBuffer As UInteger,   ' DWORD* in/out
    ppBuffer As IntPtr   ' CRYPT_PROVIDER_REFS** optional, out
) As Integer
End Function

' pszContext : LPCWSTR optional
' dwInterface : DWORD optional
' pszFunction : LPCWSTR optional
' pszProvider : LPCWSTR optional
' dwMode : BCRYPT_QUERY_PROVIDER_MODE
' dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS
' pcbBuffer : DWORD* in/out
' ppBuffer : CRYPT_PROVIDER_REFS** optional, out
Declare PtrSafe Function BCryptResolveProviders Lib "bcrypt" ( _
    ByVal pszContext As LongPtr, _
    ByVal dwInterface As Long, _
    ByVal pszFunction As LongPtr, _
    ByVal pszProvider As LongPtr, _
    ByVal dwMode As Long, _
    ByVal dwFlags As Long, _
    ByRef pcbBuffer As Long, _
    ByVal ppBuffer As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

BCryptResolveProviders = ctypes.windll.bcrypt.BCryptResolveProviders
BCryptResolveProviders.restype = ctypes.c_int
BCryptResolveProviders.argtypes = [
    wintypes.LPCWSTR,  # pszContext : LPCWSTR optional
    wintypes.DWORD,  # dwInterface : DWORD optional
    wintypes.LPCWSTR,  # pszFunction : LPCWSTR optional
    wintypes.LPCWSTR,  # pszProvider : LPCWSTR optional
    wintypes.DWORD,  # dwMode : BCRYPT_QUERY_PROVIDER_MODE
    wintypes.DWORD,  # dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS
    ctypes.POINTER(wintypes.DWORD),  # pcbBuffer : DWORD* in/out
    ctypes.c_void_p,  # ppBuffer : CRYPT_PROVIDER_REFS** optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('bcrypt.dll')
BCryptResolveProviders = Fiddle::Function.new(
  lib['BCryptResolveProviders'],
  [
    Fiddle::TYPE_VOIDP,  # pszContext : LPCWSTR optional
    -Fiddle::TYPE_INT,  # dwInterface : DWORD optional
    Fiddle::TYPE_VOIDP,  # pszFunction : LPCWSTR optional
    Fiddle::TYPE_VOIDP,  # pszProvider : LPCWSTR optional
    -Fiddle::TYPE_INT,  # dwMode : BCRYPT_QUERY_PROVIDER_MODE
    -Fiddle::TYPE_INT,  # dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS
    Fiddle::TYPE_VOIDP,  # pcbBuffer : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # ppBuffer : CRYPT_PROVIDER_REFS** optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "bcrypt")]
extern "system" {
    fn BCryptResolveProviders(
        pszContext: *const u16,  // LPCWSTR optional
        dwInterface: u32,  // DWORD optional
        pszFunction: *const u16,  // LPCWSTR optional
        pszProvider: *const u16,  // LPCWSTR optional
        dwMode: u32,  // BCRYPT_QUERY_PROVIDER_MODE
        dwFlags: u32,  // BCRYPT_RESOLVE_PROVIDERS_FLAGS
        pcbBuffer: *mut u32,  // DWORD* in/out
        ppBuffer: *mut *mut CRYPT_PROVIDER_REFS  // CRYPT_PROVIDER_REFS** optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("bcrypt.dll")]
public static extern int BCryptResolveProviders([MarshalAs(UnmanagedType.LPWStr)] string pszContext, uint dwInterface, [MarshalAs(UnmanagedType.LPWStr)] string pszFunction, [MarshalAs(UnmanagedType.LPWStr)] string pszProvider, uint dwMode, uint dwFlags, ref uint pcbBuffer, IntPtr ppBuffer);
"@
$api = Add-Type -MemberDefinition $sig -Name 'bcrypt_BCryptResolveProviders' -Namespace Win32 -PassThru
# $api::BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)

#uselib "bcrypt.dll"
#func global BCryptResolveProviders "BCryptResolveProviders" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; BCryptResolveProviders pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, varptr(pcbBuffer), varptr(ppBuffer)   ; 戻り値は stat
; pszContext : LPCWSTR optional -> "sptr"
; dwInterface : DWORD optional -> "sptr"
; pszFunction : LPCWSTR optional -> "sptr"
; pszProvider : LPCWSTR optional -> "sptr"
; dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "sptr"
; dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "sptr"
; pcbBuffer : DWORD* in/out -> "sptr"
; ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "bcrypt.dll"
#cfunc global BCryptResolveProviders "BCryptResolveProviders" wstr, int, wstr, wstr, int, int, var, var
; res = BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
; pszContext : LPCWSTR optional -> "wstr"
; dwInterface : DWORD optional -> "int"
; pszFunction : LPCWSTR optional -> "wstr"
; pszProvider : LPCWSTR optional -> "wstr"
; dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "int"
; dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "int"
; pcbBuffer : DWORD* in/out -> "var"
; ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "bcrypt.dll"
#cfunc global BCryptResolveProviders "BCryptResolveProviders" wstr, int, wstr, wstr, int, int, sptr, sptr
; res = BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, varptr(pcbBuffer), varptr(ppBuffer))
; pszContext : LPCWSTR optional -> "wstr"
; dwInterface : DWORD optional -> "int"
; pszFunction : LPCWSTR optional -> "wstr"
; pszProvider : LPCWSTR optional -> "wstr"
; dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "int"
; dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "int"
; pcbBuffer : DWORD* in/out -> "sptr"
; ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; NTSTATUS BCryptResolveProviders(LPCWSTR pszContext, DWORD dwInterface, LPCWSTR pszFunction, LPCWSTR pszProvider, BCRYPT_QUERY_PROVIDER_MODE dwMode, BCRYPT_RESOLVE_PROVIDERS_FLAGS dwFlags, DWORD* pcbBuffer, CRYPT_PROVIDER_REFS** ppBuffer)
#uselib "bcrypt.dll"
#cfunc global BCryptResolveProviders "BCryptResolveProviders" wstr, int, wstr, wstr, int, int, var, var
; res = BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
; pszContext : LPCWSTR optional -> "wstr"
; dwInterface : DWORD optional -> "int"
; pszFunction : LPCWSTR optional -> "wstr"
; pszProvider : LPCWSTR optional -> "wstr"
; dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "int"
; dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "int"
; pcbBuffer : DWORD* in/out -> "var"
; ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; NTSTATUS BCryptResolveProviders(LPCWSTR pszContext, DWORD dwInterface, LPCWSTR pszFunction, LPCWSTR pszProvider, BCRYPT_QUERY_PROVIDER_MODE dwMode, BCRYPT_RESOLVE_PROVIDERS_FLAGS dwFlags, DWORD* pcbBuffer, CRYPT_PROVIDER_REFS** ppBuffer)
#uselib "bcrypt.dll"
#cfunc global BCryptResolveProviders "BCryptResolveProviders" wstr, int, wstr, wstr, int, int, intptr, intptr
; res = BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, varptr(pcbBuffer), varptr(ppBuffer))
; pszContext : LPCWSTR optional -> "wstr"
; dwInterface : DWORD optional -> "int"
; pszFunction : LPCWSTR optional -> "wstr"
; pszProvider : LPCWSTR optional -> "wstr"
; dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "int"
; dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "int"
; pcbBuffer : DWORD* in/out -> "intptr"
; ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	bcrypt = windows.NewLazySystemDLL("bcrypt.dll")
	procBCryptResolveProviders = bcrypt.NewProc("BCryptResolveProviders")
)

// pszContext (LPCWSTR optional), dwInterface (DWORD optional), pszFunction (LPCWSTR optional), pszProvider (LPCWSTR optional), dwMode (BCRYPT_QUERY_PROVIDER_MODE), dwFlags (BCRYPT_RESOLVE_PROVIDERS_FLAGS), pcbBuffer (DWORD* in/out), ppBuffer (CRYPT_PROVIDER_REFS** optional, out)
r1, _, err := procBCryptResolveProviders.Call(
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszContext))),
	uintptr(dwInterface),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszFunction))),
	uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pszProvider))),
	uintptr(dwMode),
	uintptr(dwFlags),
	uintptr(pcbBuffer),
	uintptr(ppBuffer),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // NTSTATUS

function BCryptResolveProviders(
  pszContext: PWideChar;   // LPCWSTR optional
  dwInterface: DWORD;   // DWORD optional
  pszFunction: PWideChar;   // LPCWSTR optional
  pszProvider: PWideChar;   // LPCWSTR optional
  dwMode: DWORD;   // BCRYPT_QUERY_PROVIDER_MODE
  dwFlags: DWORD;   // BCRYPT_RESOLVE_PROVIDERS_FLAGS
  pcbBuffer: Pointer;   // DWORD* in/out
  ppBuffer: Pointer   // CRYPT_PROVIDER_REFS** optional, out
): Integer; stdcall;
  external 'bcrypt.dll' name 'BCryptResolveProviders';

result := DllCall("bcrypt\BCryptResolveProviders"
    , "WStr", pszContext   ; LPCWSTR optional
    , "UInt", dwInterface   ; DWORD optional
    , "WStr", pszFunction   ; LPCWSTR optional
    , "WStr", pszProvider   ; LPCWSTR optional
    , "UInt", dwMode   ; BCRYPT_QUERY_PROVIDER_MODE
    , "UInt", dwFlags   ; BCRYPT_RESOLVE_PROVIDERS_FLAGS
    , "Ptr", pcbBuffer   ; DWORD* in/out
    , "Ptr", ppBuffer   ; CRYPT_PROVIDER_REFS** optional, out
    , "Int")   ; return: NTSTATUS

●BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer) = DLL("bcrypt.dll", "int BCryptResolveProviders(char*, dword, char*, char*, dword, dword, void*, void*)")
# 呼び出し: BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
# pszContext : LPCWSTR optional -> "char*"
# dwInterface : DWORD optional -> "dword"
# pszFunction : LPCWSTR optional -> "char*"
# pszProvider : LPCWSTR optional -> "char*"
# dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "dword"
# dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "dword"
# pcbBuffer : DWORD* in/out -> "void*"
# ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。

const std = @import("std");

extern "bcrypt" fn BCryptResolveProviders(
    pszContext: [*c]const u16, // LPCWSTR optional
    dwInterface: u32, // DWORD optional
    pszFunction: [*c]const u16, // LPCWSTR optional
    pszProvider: [*c]const u16, // LPCWSTR optional
    dwMode: u32, // BCRYPT_QUERY_PROVIDER_MODE
    dwFlags: u32, // BCRYPT_RESOLVE_PROVIDERS_FLAGS
    pcbBuffer: [*c]u32, // DWORD* in/out
    ppBuffer: [*c][*c]CRYPT_PROVIDER_REFS // CRYPT_PROVIDER_REFS** optional, out
) callconv(std.os.windows.WINAPI) i32;

proc BCryptResolveProviders(
    pszContext: WideCString,  # LPCWSTR optional
    dwInterface: uint32,  # DWORD optional
    pszFunction: WideCString,  # LPCWSTR optional
    pszProvider: WideCString,  # LPCWSTR optional
    dwMode: uint32,  # BCRYPT_QUERY_PROVIDER_MODE
    dwFlags: uint32,  # BCRYPT_RESOLVE_PROVIDERS_FLAGS
    pcbBuffer: ptr uint32,  # DWORD* in/out
    ppBuffer: ptr CRYPT_PROVIDER_REFS  # CRYPT_PROVIDER_REFS** optional, out
): int32 {.importc: "BCryptResolveProviders", stdcall, dynlib: "bcrypt.dll".}

pragma(lib, "bcrypt");
extern(Windows)
int BCryptResolveProviders(
    const(wchar)* pszContext,   // LPCWSTR optional
    uint dwInterface,   // DWORD optional
    const(wchar)* pszFunction,   // LPCWSTR optional
    const(wchar)* pszProvider,   // LPCWSTR optional
    uint dwMode,   // BCRYPT_QUERY_PROVIDER_MODE
    uint dwFlags,   // BCRYPT_RESOLVE_PROVIDERS_FLAGS
    uint* pcbBuffer,   // DWORD* in/out
    CRYPT_PROVIDER_REFS** ppBuffer   // CRYPT_PROVIDER_REFS** optional, out
);

ccall((:BCryptResolveProviders, "bcrypt.dll"), stdcall, Int32,
      (Cwstring, UInt32, Cwstring, Cwstring, UInt32, UInt32, Ptr{UInt32}, Ptr{CRYPT_PROVIDER_REFS}),
      pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
# pszContext : LPCWSTR optional -> Cwstring
# dwInterface : DWORD optional -> UInt32
# pszFunction : LPCWSTR optional -> Cwstring
# pszProvider : LPCWSTR optional -> Cwstring
# dwMode : BCRYPT_QUERY_PROVIDER_MODE -> UInt32
# dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> UInt32
# pcbBuffer : DWORD* in/out -> Ptr{UInt32}
# ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> Ptr{CRYPT_PROVIDER_REFS}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。

local ffi = require("ffi")
ffi.cdef[[
int32_t BCryptResolveProviders(
    const uint16_t* pszContext,
    uint32_t dwInterface,
    const uint16_t* pszFunction,
    const uint16_t* pszProvider,
    uint32_t dwMode,
    uint32_t dwFlags,
    uint32_t* pcbBuffer,
    void* ppBuffer);
]]
local bcrypt = ffi.load("bcrypt")
-- bcrypt.BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
-- pszContext : LPCWSTR optional
-- dwInterface : DWORD optional
-- pszFunction : LPCWSTR optional
-- pszProvider : LPCWSTR optional
-- dwMode : BCRYPT_QUERY_PROVIDER_MODE
-- dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS
-- pcbBuffer : DWORD* in/out
-- ppBuffer : CRYPT_PROVIDER_REFS** optional, out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。

const koffi = require('koffi');
const lib = koffi.load('bcrypt.dll');
const BCryptResolveProviders = lib.func('__stdcall', 'BCryptResolveProviders', 'int32_t', ['str16', 'uint32_t', 'str16', 'str16', 'uint32_t', 'uint32_t', 'uint32_t *', 'void *']);
// BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
// pszContext : LPCWSTR optional -> 'str16'
// dwInterface : DWORD optional -> 'uint32_t'
// pszFunction : LPCWSTR optional -> 'str16'
// pszProvider : LPCWSTR optional -> 'str16'
// dwMode : BCRYPT_QUERY_PROVIDER_MODE -> 'uint32_t'
// dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> 'uint32_t'
// pcbBuffer : DWORD* in/out -> 'uint32_t *'
// ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> 'void *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。

const lib = Deno.dlopen("bcrypt.dll", {
  BCryptResolveProviders: { parameters: ["buffer", "u32", "buffer", "buffer", "u32", "u32", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer)
// pszContext : LPCWSTR optional -> "buffer"
// dwInterface : DWORD optional -> "u32"
// pszFunction : LPCWSTR optional -> "buffer"
// pszProvider : LPCWSTR optional -> "buffer"
// dwMode : BCRYPT_QUERY_PROVIDER_MODE -> "u32"
// dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> "u32"
// pcbBuffer : DWORD* in/out -> "pointer"
// ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。

<?php
$ffi = FFI::cdef(<<<C
int32_t BCryptResolveProviders(
    const uint16_t* pszContext,
    uint32_t dwInterface,
    const uint16_t* pszFunction,
    const uint16_t* pszProvider,
    uint32_t dwMode,
    uint32_t dwFlags,
    uint32_t* pcbBuffer,
    void* ppBuffer);
C, "bcrypt.dll");
// $ffi->BCryptResolveProviders(pszContext, dwInterface, pszFunction, pszProvider, dwMode, dwFlags, pcbBuffer, ppBuffer);
// pszContext : LPCWSTR optional
// dwInterface : DWORD optional
// pszFunction : LPCWSTR optional
// pszProvider : LPCWSTR optional
// dwMode : BCRYPT_QUERY_PROVIDER_MODE
// dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS
// pcbBuffer : DWORD* in/out
// ppBuffer : CRYPT_PROVIDER_REFS** optional, 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 Bcrypt extends StdCallLibrary {
    Bcrypt INSTANCE = Native.load("bcrypt", Bcrypt.class);
    int BCryptResolveProviders(
        WString pszContext,   // LPCWSTR optional
        int dwInterface,   // DWORD optional
        WString pszFunction,   // LPCWSTR optional
        WString pszProvider,   // LPCWSTR optional
        int dwMode,   // BCRYPT_QUERY_PROVIDER_MODE
        int dwFlags,   // BCRYPT_RESOLVE_PROVIDERS_FLAGS
        IntByReference pcbBuffer,   // DWORD* in/out
        Pointer ppBuffer   // CRYPT_PROVIDER_REFS** optional, out
    );
}

@[Link("bcrypt")]
lib Libbcrypt
  fun BCryptResolveProviders = BCryptResolveProviders(
    pszContext : UInt16*,   # LPCWSTR optional
    dwInterface : UInt32,   # DWORD optional
    pszFunction : UInt16*,   # LPCWSTR optional
    pszProvider : UInt16*,   # LPCWSTR optional
    dwMode : UInt32,   # BCRYPT_QUERY_PROVIDER_MODE
    dwFlags : UInt32,   # BCRYPT_RESOLVE_PROVIDERS_FLAGS
    pcbBuffer : UInt32*,   # DWORD* in/out
    ppBuffer : CRYPT_PROVIDER_REFS**   # CRYPT_PROVIDER_REFS** optional, out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。

import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef BCryptResolveProvidersNative = Int32 Function(Pointer<Utf16>, Uint32, Pointer<Utf16>, Pointer<Utf16>, Uint32, Uint32, Pointer<Uint32>, Pointer<Void>);
typedef BCryptResolveProvidersDart = int Function(Pointer<Utf16>, int, Pointer<Utf16>, Pointer<Utf16>, int, int, Pointer<Uint32>, Pointer<Void>);
final BCryptResolveProviders = DynamicLibrary.open('bcrypt.dll')
    .lookupFunction<BCryptResolveProvidersNative, BCryptResolveProvidersDart>('BCryptResolveProviders');
// pszContext : LPCWSTR optional -> Pointer<Utf16>
// dwInterface : DWORD optional -> Uint32
// pszFunction : LPCWSTR optional -> Pointer<Utf16>
// pszProvider : LPCWSTR optional -> Pointer<Utf16>
// dwMode : BCRYPT_QUERY_PROVIDER_MODE -> Uint32
// dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> Uint32
// pcbBuffer : DWORD* in/out -> Pointer<Uint32>
// ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> Pointer<Void>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。

{$mode objfpc}{$H+}
function BCryptResolveProviders(
  pszContext: PWideChar;   // LPCWSTR optional
  dwInterface: DWORD;   // DWORD optional
  pszFunction: PWideChar;   // LPCWSTR optional
  pszProvider: PWideChar;   // LPCWSTR optional
  dwMode: DWORD;   // BCRYPT_QUERY_PROVIDER_MODE
  dwFlags: DWORD;   // BCRYPT_RESOLVE_PROVIDERS_FLAGS
  pcbBuffer: Pointer;   // DWORD* in/out
  ppBuffer: Pointer   // CRYPT_PROVIDER_REFS** optional, out
): Integer; stdcall;
  external 'bcrypt.dll' name 'BCryptResolveProviders';

import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "BCryptResolveProviders"
  c_BCryptResolveProviders :: CWString -> Word32 -> CWString -> CWString -> Word32 -> Word32 -> Ptr Word32 -> Ptr () -> IO Int32
-- pszContext : LPCWSTR optional -> CWString
-- dwInterface : DWORD optional -> Word32
-- pszFunction : LPCWSTR optional -> CWString
-- pszProvider : LPCWSTR optional -> CWString
-- dwMode : BCRYPT_QUERY_PROVIDER_MODE -> Word32
-- dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> Word32
-- pcbBuffer : DWORD* in/out -> Ptr Word32
-- ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> Ptr ()
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。

open Ctypes
open Foreign

let bcryptresolveproviders =
  foreign "BCryptResolveProviders"
    ((ptr uint16_t) @-> uint32_t @-> (ptr uint16_t) @-> (ptr uint16_t) @-> uint32_t @-> uint32_t @-> (ptr uint32_t) @-> (ptr void) @-> returning int32_t)
(* pszContext : LPCWSTR optional -> (ptr uint16_t) *)
(* dwInterface : DWORD optional -> uint32_t *)
(* pszFunction : LPCWSTR optional -> (ptr uint16_t) *)
(* pszProvider : LPCWSTR optional -> (ptr uint16_t) *)
(* dwMode : BCRYPT_QUERY_PROVIDER_MODE -> uint32_t *)
(* dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> uint32_t *)
(* pcbBuffer : DWORD* in/out -> (ptr uint32_t) *)
(* ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> (ptr void) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)

(cffi:define-foreign-library bcrypt (t "bcrypt.dll"))
(cffi:use-foreign-library bcrypt)

(cffi:defcfun ("BCryptResolveProviders" bcrypt-resolve-providers :convention :stdcall) :int32
  (psz-context (:string :encoding :utf-16le))   ; LPCWSTR optional
  (dw-interface :uint32)   ; DWORD optional
  (psz-function (:string :encoding :utf-16le))   ; LPCWSTR optional
  (psz-provider (:string :encoding :utf-16le))   ; LPCWSTR optional
  (dw-mode :uint32)   ; BCRYPT_QUERY_PROVIDER_MODE
  (dw-flags :uint32)   ; BCRYPT_RESOLVE_PROVIDERS_FLAGS
  (pcb-buffer :pointer)   ; DWORD* in/out
  (pp-buffer :pointer))   ; CRYPT_PROVIDER_REFS** optional, out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。

use Win32::API;
my $BCryptResolveProviders = Win32::API::More->new('bcrypt',
    'int BCryptResolveProviders(LPCWSTR pszContext, DWORD dwInterface, LPCWSTR pszFunction, LPCWSTR pszProvider, DWORD dwMode, DWORD dwFlags, LPVOID pcbBuffer, LPVOID ppBuffer)');
# my $ret = $BCryptResolveProviders->Call($pszContext, $dwInterface, $pszFunction, $pszProvider, $dwMode, $dwFlags, $pcbBuffer, $ppBuffer);
# pszContext : LPCWSTR optional -> LPCWSTR
# dwInterface : DWORD optional -> DWORD
# pszFunction : LPCWSTR optional -> LPCWSTR
# pszProvider : LPCWSTR optional -> LPCWSTR
# dwMode : BCRYPT_QUERY_PROVIDER_MODE -> DWORD
# dwFlags : BCRYPT_RESOLVE_PROVIDERS_FLAGS -> DWORD
# pcbBuffer : DWORD* in/out -> LPVOID
# ppBuffer : CRYPT_PROVIDER_REFS** optional, out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

BCryptResolveProviders

シグネチャ

パラメーター

公式ドキュメント

戻り値

解説(Remarks)

各言語での呼び出し定義

関連項目