CryptFindOIDInfo
関数シグネチャ
// CRYPT32.dll
#include <windows.h>
CRYPT_OID_INFO* CryptFindOIDInfo(
DWORD dwKeyType,
void* pvKey,
DWORD dwGroupId
);パラメーター
| 名前 | 型 | 方向 | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| dwKeyType | DWORD | in | OID 情報を検索するときに使用するキー型を指定します。 このパラメーターには、次のキー型のいずれかを指定できます。 CRYPT_OID_INFO_OID_KEYpvKey は、検索対象の OID 文字列を含む、null で終わる ANSI 文字列のアドレスです。 CRYPT_OID_INFO_NAME_KEYpvKey は、検索対象の名前を含む、null で終わる Unicode 文字列のアドレスです。 CRYPT_OID_INFO_ALGID_KEYpvKey は、 ALG_ID 変数のアドレスです。次の ALG_ID がサポートされます。 ハッシュ アルゴリズム: 対称暗号化アルゴリズム: 公開鍵アルゴリズム: ここに記載されていないアルゴリズムは、Cryptography API: Next Generation (CNG) を使用する場合にのみサポートされます。その場合は CRYPT_OID_INFO_CNG_ALGID_KEY を使用してください。 CRYPT_OID_INFO_SIGN_KEYpvKey は、2 つの ALG_ID から成る配列のアドレスです。最初の要素にはハッシュ アルゴリズム識別子が、2 番目の要素には公開鍵アルゴリズム識別子が格納されます。 次の ALG_ID の組み合わせがサポートされます。
ここに記載されていないアルゴリズムは CNG を介してのみサポートされます。その場合は CRYPT_OID_INFO_CNG_SIGN_KEY を使用してください。 CRYPT_OID_INFO_CNG_ALGID_KEYpvKey は、検索対象の CNG アルゴリズム識別子を含む、null で終わる Unicode 文字列のアドレスです。これは、定義済みの CNG Algorithm Identifiers のいずれか、または登録済みの別のアルゴリズム識別子です。 Windows Server 2003 R2 Windows Server 2003 : このキー型はサポートされません。CRYPT_OID_INFO_CNG_SIGN_KEYpvKey は、null で終わる Unicode 文字列ポインターを 2 つ含む配列のアドレスです。最初の文字列にはハッシュ CNG アルゴリズム識別子が、2 番目の文字列には公開鍵 CNG アルゴリズム識別子が格納されます。これらは、定義済みの CNG Algorithm Identifiers または登録済みの別のアルゴリズム識別子です。 Windows Server 2003 R2 Windows Server 2003 : このキー型はサポートされません。必要に応じて、論理 OR 演算子 (|) を使用して、次のキー型を dwKeyType パラメーターに指定できます。
| ||||||||||||||
| pvKey | void* | in | 追加の検索情報を含むバッファーのアドレスです。このパラメーターは dwKeyType パラメーターの値に依存します。詳細については、dwKeyType の下の表を参照してください。 | ||||||||||||||
| dwGroupId | DWORD | in | OID 情報を検索するときに使用するグループ識別子です。このパラメーターを 0 に設定すると、dwKeyType パラメーターに従ってすべてのグループが検索されます。それ以外の場合は、指定された dwGroupId のみが検索されます。 グループ識別子別に OID 情報を列挙するコードについては、 CryptEnumOIDInfo を参照してください。 必要に応じて、論理 OR 演算子 (|) を使用して、次のフラグを dwGroupId パラメーターに指定できます。
論理 OR 演算子 (|) を使用して、左に 16 ビット シフトしたビット長を dwGroupId パラメーターに指定できます。詳細については「解説」を参照してください。 |
戻り値の型: CRYPT_OID_INFO*
公式ドキュメント
指定したキー型とキーに一致する、定義済みまたは登録済みの最初の CRYPT_OID_INFO 構造体を取得します。検索は、指定した OID グループ内のオブジェクト識別子 (OID) に限定できます。
戻り値
CRYPT_OID_INFO 型の定数構造体へのポインターを返します。返されたポインターを解放しないでください。指定したキーとグループが見つからない場合は、NULL が返されます。
解説(Remarks)
CryptFindOIDInfo 関数は、次の条件下で OID のフレンドリ名を取得するために Active Directory 内を検索します。
- dwKeyType パラメーターのキー型が CRYPT_OID_INFO_OID_KEY または CRYPT_OID_INFO_NAME_KEY に設定されている。
- dwGroupId パラメーターにグループ識別子が指定されていない、または GroupID が EKU OID、ポリシー OID、もしくはテンプレート OID を参照している。
論理 OR 演算子 (|) を使用して、左に 16 ビット シフトしたビット長を dwGroupId パラメーターに指定できます。これは、CRYPT_OID_INFO 構造体の ExtraInfo メンバーでビット長が指定されている CRYPT_ENCRYPT_ALG_OID_GROUP_ID グループのエントリにのみ適用されます。現在のところ、これに該当するのは AES 暗号化アルゴリズムのみです。シフトには定数 CRYPT_OID_INFO_OID_GROUP_BIT_LEN_SHIFT を使用できます。たとえば、ビット長が 192 の BCRYPT_AES_ALGORITHM の OID 情報を検索するには、次のように CryptFindOIDInfo を呼び出します。
DWORD dwBitLen = 192;
PCCRYPT_OID_INFO pOIDInfo = CryptFindOIDInfo(
CRYPT_OID_INFO_CNG_ALGID_KEY,
(void *) BCRYPT_AES_ALGORITHM,
CRYPT_ENCRYPT_ALG_OID_GROUP_ID |
(dwBitLen << CRYPT_OID_INFO_OID_GROUP_BIT_LEN_SHIFT)
);
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での呼び出し定義
// CRYPT32.dll
#include <windows.h>
CRYPT_OID_INFO* CryptFindOIDInfo(
DWORD dwKeyType,
void* pvKey,
DWORD dwGroupId
);[DllImport("CRYPT32.dll", ExactSpelling = true)]
static extern IntPtr CryptFindOIDInfo(
uint dwKeyType, // DWORD
IntPtr pvKey, // void*
uint dwGroupId // DWORD
);<DllImport("CRYPT32.dll", ExactSpelling:=True)>
Public Shared Function CryptFindOIDInfo(
dwKeyType As UInteger, ' DWORD
pvKey As IntPtr, ' void*
dwGroupId As UInteger ' DWORD
) As IntPtr
End Function' dwKeyType : DWORD
' pvKey : void*
' dwGroupId : DWORD
Declare PtrSafe Function CryptFindOIDInfo Lib "crypt32" ( _
ByVal dwKeyType As Long, _
ByVal pvKey As LongPtr, _
ByVal dwGroupId As Long) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CryptFindOIDInfo = ctypes.windll.crypt32.CryptFindOIDInfo
CryptFindOIDInfo.restype = ctypes.c_void_p
CryptFindOIDInfo.argtypes = [
wintypes.DWORD, # dwKeyType : DWORD
ctypes.POINTER(None), # pvKey : void*
wintypes.DWORD, # dwGroupId : DWORD
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('CRYPT32.dll')
CryptFindOIDInfo = Fiddle::Function.new(
lib['CryptFindOIDInfo'],
[
-Fiddle::TYPE_INT, # dwKeyType : DWORD
Fiddle::TYPE_VOIDP, # pvKey : void*
-Fiddle::TYPE_INT, # dwGroupId : DWORD
],
Fiddle::TYPE_VOIDP)#[link(name = "crypt32")]
extern "system" {
fn CryptFindOIDInfo(
dwKeyType: u32, // DWORD
pvKey: *mut (), // void*
dwGroupId: u32 // DWORD
) -> *mut CRYPT_OID_INFO;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("CRYPT32.dll")]
public static extern IntPtr CryptFindOIDInfo(uint dwKeyType, IntPtr pvKey, uint dwGroupId);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPT32_CryptFindOIDInfo' -Namespace Win32 -PassThru
# $api::CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)#uselib "CRYPT32.dll"
#func global CryptFindOIDInfo "CryptFindOIDInfo" sptr, sptr, sptr
; CryptFindOIDInfo dwKeyType, pvKey, dwGroupId ; 戻り値は stat
; dwKeyType : DWORD -> "sptr"
; pvKey : void* -> "sptr"
; dwGroupId : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。#uselib "CRYPT32.dll"
#cfunc global CryptFindOIDInfo "CryptFindOIDInfo" int, sptr, int
; res = CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
; dwKeyType : DWORD -> "int"
; pvKey : void* -> "sptr"
; dwGroupId : DWORD -> "int"; CRYPT_OID_INFO* CryptFindOIDInfo(DWORD dwKeyType, void* pvKey, DWORD dwGroupId)
#uselib "CRYPT32.dll"
#cfunc global CryptFindOIDInfo "CryptFindOIDInfo" int, intptr, int
; res = CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
; dwKeyType : DWORD -> "int"
; pvKey : void* -> "intptr"
; dwGroupId : DWORD -> "int"import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
crypt32 = windows.NewLazySystemDLL("CRYPT32.dll")
procCryptFindOIDInfo = crypt32.NewProc("CryptFindOIDInfo")
)
// dwKeyType (DWORD), pvKey (void*), dwGroupId (DWORD)
r1, _, err := procCryptFindOIDInfo.Call(
uintptr(dwKeyType),
uintptr(pvKey),
uintptr(dwGroupId),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // CRYPT_OID_INFO*function CryptFindOIDInfo(
dwKeyType: DWORD; // DWORD
pvKey: Pointer; // void*
dwGroupId: DWORD // DWORD
): Pointer; stdcall;
external 'CRYPT32.dll' name 'CryptFindOIDInfo';result := DllCall("CRYPT32\CryptFindOIDInfo"
, "UInt", dwKeyType ; DWORD
, "Ptr", pvKey ; void*
, "UInt", dwGroupId ; DWORD
, "Ptr") ; return: CRYPT_OID_INFO*●CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId) = DLL("CRYPT32.dll", "void* CryptFindOIDInfo(dword, void*, dword)")
# 呼び出し: CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
# dwKeyType : DWORD -> "dword"
# pvKey : void* -> "void*"
# dwGroupId : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "crypt32" fn CryptFindOIDInfo(
dwKeyType: u32, // DWORD
pvKey: ?*anyopaque, // void*
dwGroupId: u32 // DWORD
) callconv(std.os.windows.WINAPI) [*c]CRYPT_OID_INFO;proc CryptFindOIDInfo(
dwKeyType: uint32, # DWORD
pvKey: pointer, # void*
dwGroupId: uint32 # DWORD
): ptr CRYPT_OID_INFO {.importc: "CryptFindOIDInfo", stdcall, dynlib: "CRYPT32.dll".}pragma(lib, "crypt32");
extern(Windows)
CRYPT_OID_INFO* CryptFindOIDInfo(
uint dwKeyType, // DWORD
void* pvKey, // void*
uint dwGroupId // DWORD
);ccall((:CryptFindOIDInfo, "CRYPT32.dll"), stdcall, Ptr{CRYPT_OID_INFO},
(UInt32, Ptr{Cvoid}, UInt32),
dwKeyType, pvKey, dwGroupId)
# dwKeyType : DWORD -> UInt32
# pvKey : void* -> Ptr{Cvoid}
# dwGroupId : DWORD -> UInt32
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
void* CryptFindOIDInfo(
uint32_t dwKeyType,
void* pvKey,
uint32_t dwGroupId);
]]
local crypt32 = ffi.load("crypt32")
-- crypt32.CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
-- dwKeyType : DWORD
-- pvKey : void*
-- dwGroupId : DWORD
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('CRYPT32.dll');
const CryptFindOIDInfo = lib.func('__stdcall', 'CryptFindOIDInfo', 'void *', ['uint32_t', 'void *', 'uint32_t']);
// CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
// dwKeyType : DWORD -> 'uint32_t'
// pvKey : void* -> 'void *'
// dwGroupId : DWORD -> 'uint32_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("CRYPT32.dll", {
CryptFindOIDInfo: { parameters: ["u32", "pointer", "u32"], result: "pointer" },
});
// lib.symbols.CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId)
// dwKeyType : DWORD -> "u32"
// pvKey : void* -> "pointer"
// dwGroupId : DWORD -> "u32"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
void* CryptFindOIDInfo(
uint32_t dwKeyType,
void* pvKey,
uint32_t dwGroupId);
C, "CRYPT32.dll");
// $ffi->CryptFindOIDInfo(dwKeyType, pvKey, dwGroupId);
// dwKeyType : DWORD
// pvKey : void*
// dwGroupId : DWORD
// 構造体/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 Crypt32 extends StdCallLibrary {
Crypt32 INSTANCE = Native.load("crypt32", Crypt32.class);
Pointer CryptFindOIDInfo(
int dwKeyType, // DWORD
Pointer pvKey, // void*
int dwGroupId // DWORD
);
}@[Link("crypt32")]
lib LibCRYPT32
fun CryptFindOIDInfo = CryptFindOIDInfo(
dwKeyType : UInt32, # DWORD
pvKey : Void*, # void*
dwGroupId : UInt32 # DWORD
) : CRYPT_OID_INFO*
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef CryptFindOIDInfoNative = Pointer<Void> Function(Uint32, Pointer<Void>, Uint32);
typedef CryptFindOIDInfoDart = Pointer<Void> Function(int, Pointer<Void>, int);
final CryptFindOIDInfo = DynamicLibrary.open('CRYPT32.dll')
.lookupFunction<CryptFindOIDInfoNative, CryptFindOIDInfoDart>('CryptFindOIDInfo');
// dwKeyType : DWORD -> Uint32
// pvKey : void* -> Pointer<Void>
// dwGroupId : DWORD -> Uint32
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function CryptFindOIDInfo(
dwKeyType: DWORD; // DWORD
pvKey: Pointer; // void*
dwGroupId: DWORD // DWORD
): Pointer; stdcall;
external 'CRYPT32.dll' name 'CryptFindOIDInfo';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "CryptFindOIDInfo"
c_CryptFindOIDInfo :: Word32 -> Ptr () -> Word32 -> IO (Ptr ())
-- dwKeyType : DWORD -> Word32
-- pvKey : void* -> Ptr ()
-- dwGroupId : DWORD -> Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let cryptfindoidinfo =
foreign "CryptFindOIDInfo"
(uint32_t @-> (ptr void) @-> uint32_t @-> returning (ptr void))
(* dwKeyType : DWORD -> uint32_t *)
(* pvKey : void* -> (ptr void) *)
(* dwGroupId : DWORD -> uint32_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library crypt32 (t "CRYPT32.dll"))
(cffi:use-foreign-library crypt32)
(cffi:defcfun ("CryptFindOIDInfo" crypt-find-oidinfo :convention :stdcall) :pointer
(dw-key-type :uint32) ; DWORD
(pv-key :pointer) ; void*
(dw-group-id :uint32)) ; DWORD
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $CryptFindOIDInfo = Win32::API::More->new('CRYPT32',
'LPVOID CryptFindOIDInfo(DWORD dwKeyType, LPVOID pvKey, DWORD dwGroupId)');
# my $ret = $CryptFindOIDInfo->Call($dwKeyType, $pvKey, $dwGroupId);
# dwKeyType : DWORD -> DWORD
# pvKey : void* -> LPVOID
# dwGroupId : DWORD -> DWORD
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。関連項目
- s CRYPT_ALGORITHM_IDENTIFIER
- f CryptRegisterOIDInfo — OID情報をシステムに登録する。
- f CryptUnregisterOIDInfo — 登録済みのOID情報を解除する。