ホーム › Security.Cryptography › CryptInstallOIDFunctionAddress

CryptInstallOIDFunctionAddress

関数

OID関数のアドレスを登録テーブルにインストールする。

DLLCRYPT32.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

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

BOOL CryptInstallOIDFunctionAddress(
    HMODULE hModule,   // optional
    DWORD dwEncodingType,
    LPCSTR pszFuncName,
    DWORD cFuncEntry,
    const CRYPT_OID_FUNC_ENTRY* rgFuncEntry,
    DWORD dwFlags
);

パラメーター

名前	型	方向	説明
hModule	HMODULE	inoptional	このパラメーターは、DllMain に渡された hModule パラメーターで更新されます。これにより、関数アドレスを含む DLL が CryptGetOIDFunctionAddress または CryptFreeOIDFunctionAddress によってアンロードされるのを防ぎます。これは、その DLL が CryptRegisterOIDFunction を通じて OID 関数も登録している場合に該当します。
dwEncodingType	DWORD	in	一致させるエンコーディングの種類を指定します。現在は X509_ASN_ENCODING と PKCS_7_ASN_ENCODING のみが使用されていますが、将来的に追加のエンコーディングの種類が加わる可能性があります。現在の両方のエンコーディングの種類に一致させるには、次のように指定します。 X509_ASN_ENCODING \| PKCS_7_ASN_ENCODING
pszFuncName	LPCSTR	in	インストールする関数セットの名前。
cFuncEntry	DWORD	in	rgFuncEntry[] 内の配列要素の数。
rgFuncEntry	CRYPT_OID_FUNC_ENTRY*	in	CRYPT_OID_FUNC_ENTRY 構造体の配列で、各要素には OID と、それに対応するルーチンの開始アドレスが含まれます。既定の関数をインストールするには、その配列要素の CRYPT_OID_FUNC_ENTRY 構造体の pszOID メンバーに CRYPT_DEFAULT_OID を設定します。
dwFlags	DWORD	in	既定では、新しい関数セットは関数セットの一覧の末尾にインストールされます。CRYPT_INSTALL_OID_FUNC_BEFORE_FLAG フラグを設定すると、関数セットは一覧の先頭にインストールされます。

戻り値の型: BOOL

公式ドキュメント

CryptInstallOIDFunctionAddress 関数は、呼び出し可能なオブジェクト識別子 (OID) 関数アドレスのセットをインストールします。

戻り値

関数が成功した場合は、0 以外の値 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。

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

各言語での呼び出し定義

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

BOOL CryptInstallOIDFunctionAddress(
    HMODULE hModule,   // optional
    DWORD dwEncodingType,
    LPCSTR pszFuncName,
    DWORD cFuncEntry,
    const CRYPT_OID_FUNC_ENTRY* rgFuncEntry,
    DWORD dwFlags
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll", ExactSpelling = true)]
static extern bool CryptInstallOIDFunctionAddress(
    IntPtr hModule,   // HMODULE optional
    uint dwEncodingType,   // DWORD
    [MarshalAs(UnmanagedType.LPStr)] string pszFuncName,   // LPCSTR
    uint cFuncEntry,   // DWORD
    IntPtr rgFuncEntry,   // CRYPT_OID_FUNC_ENTRY*
    uint dwFlags   // DWORD
);

<DllImport("CRYPT32.dll", ExactSpelling:=True)>
Public Shared Function CryptInstallOIDFunctionAddress(
    hModule As IntPtr,   ' HMODULE optional
    dwEncodingType As UInteger,   ' DWORD
    <MarshalAs(UnmanagedType.LPStr)> pszFuncName As String,   ' LPCSTR
    cFuncEntry As UInteger,   ' DWORD
    rgFuncEntry As IntPtr,   ' CRYPT_OID_FUNC_ENTRY*
    dwFlags As UInteger   ' DWORD
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' hModule : HMODULE optional
' dwEncodingType : DWORD
' pszFuncName : LPCSTR
' cFuncEntry : DWORD
' rgFuncEntry : CRYPT_OID_FUNC_ENTRY*
' dwFlags : DWORD
Declare PtrSafe Function CryptInstallOIDFunctionAddress Lib "crypt32" ( _
    ByVal hModule As LongPtr, _
    ByVal dwEncodingType As Long, _
    ByVal pszFuncName As String, _
    ByVal cFuncEntry As Long, _
    ByVal rgFuncEntry As LongPtr, _
    ByVal dwFlags As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

CryptInstallOIDFunctionAddress = ctypes.windll.crypt32.CryptInstallOIDFunctionAddress
CryptInstallOIDFunctionAddress.restype = wintypes.BOOL
CryptInstallOIDFunctionAddress.argtypes = [
    wintypes.HANDLE,  # hModule : HMODULE optional
    wintypes.DWORD,  # dwEncodingType : DWORD
    wintypes.LPCSTR,  # pszFuncName : LPCSTR
    wintypes.DWORD,  # cFuncEntry : DWORD
    ctypes.c_void_p,  # rgFuncEntry : CRYPT_OID_FUNC_ENTRY*
    wintypes.DWORD,  # dwFlags : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPT32.dll')
CryptInstallOIDFunctionAddress = Fiddle::Function.new(
  lib['CryptInstallOIDFunctionAddress'],
  [
    Fiddle::TYPE_VOIDP,  # hModule : HMODULE optional
    -Fiddle::TYPE_INT,  # dwEncodingType : DWORD
    Fiddle::TYPE_VOIDP,  # pszFuncName : LPCSTR
    -Fiddle::TYPE_INT,  # cFuncEntry : DWORD
    Fiddle::TYPE_VOIDP,  # rgFuncEntry : CRYPT_OID_FUNC_ENTRY*
    -Fiddle::TYPE_INT,  # dwFlags : DWORD
  ],
  Fiddle::TYPE_INT)

#[link(name = "crypt32")]
extern "system" {
    fn CryptInstallOIDFunctionAddress(
        hModule: *mut core::ffi::c_void,  // HMODULE optional
        dwEncodingType: u32,  // DWORD
        pszFuncName: *const u8,  // LPCSTR
        cFuncEntry: u32,  // DWORD
        rgFuncEntry: *const CRYPT_OID_FUNC_ENTRY,  // CRYPT_OID_FUNC_ENTRY*
        dwFlags: u32  // DWORD
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPT32.dll")]
public static extern bool CryptInstallOIDFunctionAddress(IntPtr hModule, uint dwEncodingType, [MarshalAs(UnmanagedType.LPStr)] string pszFuncName, uint cFuncEntry, IntPtr rgFuncEntry, uint dwFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CryptInstallOIDFunctionAddress' -Namespace Win32 -PassThru
# $api::CryptInstallOIDFunctionAddress(hModule, dwEncodingType, pszFuncName, cFuncEntry, rgFuncEntry, dwFlags)

#uselib "CRYPT32.dll"
#func global CryptInstallOIDFunctionAddress "CryptInstallOIDFunctionAddress" sptr, sptr, sptr, sptr, sptr, sptr
; CryptInstallOIDFunctionAddress hModule, dwEncodingType, pszFuncName, cFuncEntry, varptr(rgFuncEntry), dwFlags   ; 戻り値は stat
; hModule : HMODULE optional -> "sptr"
; dwEncodingType : DWORD -> "sptr"
; pszFuncName : LPCSTR -> "sptr"
; cFuncEntry : DWORD -> "sptr"
; rgFuncEntry : CRYPT_OID_FUNC_ENTRY* -> "sptr"
; dwFlags : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "CRYPT32.dll"
#cfunc global CryptInstallOIDFunctionAddress "CryptInstallOIDFunctionAddress" sptr, int, str, int, var, int
; res = CryptInstallOIDFunctionAddress(hModule, dwEncodingType, pszFuncName, cFuncEntry, rgFuncEntry, dwFlags)
; hModule : HMODULE optional -> "sptr"
; dwEncodingType : DWORD -> "int"
; pszFuncName : LPCSTR -> "str"
; cFuncEntry : DWORD -> "int"
; rgFuncEntry : CRYPT_OID_FUNC_ENTRY* -> "var"
; dwFlags : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPT32.dll"
#cfunc global CryptInstallOIDFunctionAddress "CryptInstallOIDFunctionAddress" sptr, int, str, int, sptr, int
; res = CryptInstallOIDFunctionAddress(hModule, dwEncodingType, pszFuncName, cFuncEntry, varptr(rgFuncEntry), dwFlags)
; hModule : HMODULE optional -> "sptr"
; dwEncodingType : DWORD -> "int"
; pszFuncName : LPCSTR -> "str"
; cFuncEntry : DWORD -> "int"
; rgFuncEntry : CRYPT_OID_FUNC_ENTRY* -> "sptr"
; dwFlags : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。