Win32 API 日本語リファレンス
ホームSecurity.Cryptography › CryptFindOIDInfo

CryptFindOIDInfo

関数
指定キーに一致するOID情報を検索して取得する。
DLLCRYPT32.dll呼出規約winapi対応OSWindows XP 以降

シグネチャ

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

CRYPT_OID_INFO* CryptFindOIDInfo(
    DWORD dwKeyType,
    void* pvKey,
    DWORD dwGroupId
);

パラメーター

名前方向説明
dwKeyTypeDWORDin

OID 情報を検索するときに使用するキー型を指定します。

このパラメーターには、次のキー型のいずれかを指定できます。

CRYPT_OID_INFO_OID_KEY

pvKey は、検索対象の OID 文字列を含む、null で終わる ANSI 文字列のアドレスです。

CRYPT_OID_INFO_NAME_KEY

pvKey は、検索対象の名前を含む、null で終わる Unicode 文字列のアドレスです。

CRYPT_OID_INFO_ALGID_KEY

pvKey は、 ALG_ID 変数のアドレスです。次の ALG_ID がサポートされます。

ハッシュ アルゴリズム:

対称暗号化アルゴリズム:

公開鍵アルゴリズム:

ここに記載されていないアルゴリズムは、Cryptography API: Next Generation (CNG) を使用する場合にのみサポートされます。その場合は CRYPT_OID_INFO_CNG_ALGID_KEY を使用してください。

CRYPT_OID_INFO_SIGN_KEY

pvKey は、2 つの ALG_ID から成る配列のアドレスです。最初の要素にはハッシュ アルゴリズム識別子が、2 番目の要素には公開鍵アルゴリズム識別子が格納されます。

次の ALG_ID の組み合わせがサポートされます。

署名アルゴリズム識別子 ハッシュ アルゴリズム識別子
CALG_RSA_SIGN
CALG_SHA1
CALG_MD5
CALG_MD4
CALG_MD2
CALG_DSS_SIGN
CALG_SHA1
CALG_NO_SIGN
CALG_SHA1
CALG_NO_SIGN

ここに記載されていないアルゴリズムは CNG を介してのみサポートされます。その場合は CRYPT_OID_INFO_CNG_SIGN_KEY を使用してください。

CRYPT_OID_INFO_CNG_ALGID_KEY

pvKey は、検索対象の CNG アルゴリズム識別子を含む、null で終わる Unicode 文字列のアドレスです。これは、定義済みの CNG Algorithm Identifiers のいずれか、または登録済みの別のアルゴリズム識別子です。

Windows Server 2003 R2 Windows Server 2003 : このキー型はサポートされません。

CRYPT_OID_INFO_CNG_SIGN_KEY

pvKey は、null で終わる Unicode 文字列ポインターを 2 つ含む配列のアドレスです。最初の文字列にはハッシュ CNG アルゴリズム識別子が、2 番目の文字列には公開鍵 CNG アルゴリズム識別子が格納されます。これらは、定義済みの CNG Algorithm Identifiers または登録済みの別のアルゴリズム識別子です。

Windows Server 2003 R2 Windows Server 2003 : このキー型はサポートされません。

必要に応じて、論理 OR 演算子 (|) を使用して、次のキー型を dwKeyType パラメーターに指定できます。

意味
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
CRYPT_PUBKEY_ALG_OID_GROUP_ID グループ内で、CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG フラグが明示的に設定されている公開鍵をスキップします。
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
CRYPT_PUBKEY_ALG_OID_GROUP_ID グループ内で、CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG フラグが明示的に設定されている公開鍵をスキップします。
pvKeyvoid*in追加の検索情報を含むバッファーのアドレスです。このパラメーターは dwKeyType パラメーターの値に依存します。詳細については、dwKeyType の下の表を参照してください。
dwGroupIdDWORDin

OID 情報を検索するときに使用するグループ識別子です。このパラメーターを 0 に設定すると、dwKeyType パラメーターに従ってすべてのグループが検索されます。それ以外の場合は、指定された dwGroupId のみが検索されます。

グループ識別子別に OID 情報を列挙するコードについては、 CryptEnumOIDInfo を参照してください。

必要に応じて、論理 OR 演算子 (|) を使用して、次のフラグを dwGroupId パラメーターに指定できます。

意味
CRYPT_OID_DISABLE_SEARCH_DS_FLAG
ディレクトリ サーバーの検索を無効にします。

論理 OR 演算子 (|) を使用して、左に 16 ビット シフトしたビット長を dwGroupId パラメーターに指定できます。詳細については「解説」を参照してください。

戻り値の型: CRYPT_OID_INFO*

公式ドキュメント

指定したキー型とキーに一致する、定義済みまたは登録済みの最初の CRYPT_OID_INFO 構造体を取得します。検索は、指定した OID グループ内のオブジェクト識別子 (OID) に限定できます。

戻り値

CRYPT_OID_INFO 型の定数構造体へのポインターを返します。返されたポインターを解放しないでください。指定したキーとグループが見つからない場合は、NULL が返されます。

解説(Remarks)

CryptFindOIDInfo 関数は、次の条件下で OID のフレンドリ名を取得するために Active Directory 内を検索します。

CRYPT_OID_DISABLE_SEARCH_DS_FLAG フラグを指定して関数を呼び出すことで、フレンドリ名のネットワーク取得を抑制できます。

論理 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 の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
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 を使用。

関連項目

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