ホーム › Security.Cryptography › CryptGetObjectUrl

CryptGetObjectUrl

関数

証明書などから関連オブジェクトの取得URL一覧を取得する。

DLLCRYPTNET.dll呼出規約winapiSetLastErrorあり対応OSWindows XP 以降

シグネチャ

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

BOOL CryptGetObjectUrl(
    LPCSTR pszUrlOid,
    void* pvPara,
    CRYPT_GET_URL_FLAGS dwFlags,
    CRYPT_URL_ARRAY* pUrlArray,   // optional
    DWORD* pcbUrlArray,
    CRYPT_URL_INFO* pUrlInfo,   // optional
    DWORD* pcbUrlInfo,   // optional
    void* pvReserved   // optional
);

パラメーター

名前	型	方向
pszUrlOid	LPCSTR	in
pvPara	void*	in
dwFlags	CRYPT_GET_URL_FLAGS	in
pUrlArray	CRYPT_URL_ARRAY*	outoptional
pcbUrlArray	DWORD*	inout
pUrlInfo	CRYPT_URL_INFO*	outoptional
pcbUrlInfo	DWORD*	inoutoptional
pvReserved	void*	optional

戻り値の型: BOOL

各言語での呼び出し定義

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

BOOL CryptGetObjectUrl(
    LPCSTR pszUrlOid,
    void* pvPara,
    CRYPT_GET_URL_FLAGS dwFlags,
    CRYPT_URL_ARRAY* pUrlArray,   // optional
    DWORD* pcbUrlArray,
    CRYPT_URL_INFO* pUrlInfo,   // optional
    DWORD* pcbUrlInfo,   // optional
    void* pvReserved   // optional
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPTNET.dll", SetLastError = true, ExactSpelling = true)]
static extern bool CryptGetObjectUrl(
    [MarshalAs(UnmanagedType.LPStr)] string pszUrlOid,   // LPCSTR
    IntPtr pvPara,   // void*
    uint dwFlags,   // CRYPT_GET_URL_FLAGS
    IntPtr pUrlArray,   // CRYPT_URL_ARRAY* optional, out
    ref uint pcbUrlArray,   // DWORD* in/out
    IntPtr pUrlInfo,   // CRYPT_URL_INFO* optional, out
    IntPtr pcbUrlInfo,   // DWORD* optional, in/out
    IntPtr pvReserved   // void* optional
);

<DllImport("CRYPTNET.dll", SetLastError:=True, ExactSpelling:=True)>
Public Shared Function CryptGetObjectUrl(
    <MarshalAs(UnmanagedType.LPStr)> pszUrlOid As String,   ' LPCSTR
    pvPara As IntPtr,   ' void*
    dwFlags As UInteger,   ' CRYPT_GET_URL_FLAGS
    pUrlArray As IntPtr,   ' CRYPT_URL_ARRAY* optional, out
    ByRef pcbUrlArray As UInteger,   ' DWORD* in/out
    pUrlInfo As IntPtr,   ' CRYPT_URL_INFO* optional, out
    pcbUrlInfo As IntPtr,   ' DWORD* optional, in/out
    pvReserved As IntPtr   ' void* optional
) As Boolean
End Function

' pszUrlOid : LPCSTR
' pvPara : void*
' dwFlags : CRYPT_GET_URL_FLAGS
' pUrlArray : CRYPT_URL_ARRAY* optional, out
' pcbUrlArray : DWORD* in/out
' pUrlInfo : CRYPT_URL_INFO* optional, out
' pcbUrlInfo : DWORD* optional, in/out
' pvReserved : void* optional
Declare PtrSafe Function CryptGetObjectUrl Lib "cryptnet" ( _
    ByVal pszUrlOid As String, _
    ByVal pvPara As LongPtr, _
    ByVal dwFlags As Long, _
    ByVal pUrlArray As LongPtr, _
    ByRef pcbUrlArray As Long, _
    ByVal pUrlInfo As LongPtr, _
    ByVal pcbUrlInfo As LongPtr, _
    ByVal pvReserved As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

CryptGetObjectUrl = ctypes.windll.cryptnet.CryptGetObjectUrl
CryptGetObjectUrl.restype = wintypes.BOOL
CryptGetObjectUrl.argtypes = [
    wintypes.LPCSTR,  # pszUrlOid : LPCSTR
    ctypes.POINTER(None),  # pvPara : void*
    wintypes.DWORD,  # dwFlags : CRYPT_GET_URL_FLAGS
    ctypes.c_void_p,  # pUrlArray : CRYPT_URL_ARRAY* optional, out
    ctypes.POINTER(wintypes.DWORD),  # pcbUrlArray : DWORD* in/out
    ctypes.c_void_p,  # pUrlInfo : CRYPT_URL_INFO* optional, out
    ctypes.POINTER(wintypes.DWORD),  # pcbUrlInfo : DWORD* optional, in/out
    ctypes.POINTER(None),  # pvReserved : void* optional
]
# GetLastError: use ctypes.GetLastError() (or ctypes.WinDLL(use_last_error=True))

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CRYPTNET.dll')
CryptGetObjectUrl = Fiddle::Function.new(
  lib['CryptGetObjectUrl'],
  [
    Fiddle::TYPE_VOIDP,  # pszUrlOid : LPCSTR
    Fiddle::TYPE_VOIDP,  # pvPara : void*
    -Fiddle::TYPE_INT,  # dwFlags : CRYPT_GET_URL_FLAGS
    Fiddle::TYPE_VOIDP,  # pUrlArray : CRYPT_URL_ARRAY* optional, out
    Fiddle::TYPE_VOIDP,  # pcbUrlArray : DWORD* in/out
    Fiddle::TYPE_VOIDP,  # pUrlInfo : CRYPT_URL_INFO* optional, out
    Fiddle::TYPE_VOIDP,  # pcbUrlInfo : DWORD* optional, in/out
    Fiddle::TYPE_VOIDP,  # pvReserved : void* optional
  ],
  Fiddle::TYPE_INT)

#[link(name = "cryptnet")]
extern "system" {
    fn CryptGetObjectUrl(
        pszUrlOid: *const u8,  // LPCSTR
        pvPara: *mut (),  // void*
        dwFlags: u32,  // CRYPT_GET_URL_FLAGS
        pUrlArray: *mut CRYPT_URL_ARRAY,  // CRYPT_URL_ARRAY* optional, out
        pcbUrlArray: *mut u32,  // DWORD* in/out
        pUrlInfo: *mut CRYPT_URL_INFO,  // CRYPT_URL_INFO* optional, out
        pcbUrlInfo: *mut u32,  // DWORD* optional, in/out
        pvReserved: *mut ()  // void* optional
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("CRYPTNET.dll", SetLastError = true)]
public static extern bool CryptGetObjectUrl([MarshalAs(UnmanagedType.LPStr)] string pszUrlOid, IntPtr pvPara, uint dwFlags, IntPtr pUrlArray, ref uint pcbUrlArray, IntPtr pUrlInfo, IntPtr pcbUrlInfo, IntPtr pvReserved);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CRYPTNET_CryptGetObjectUrl' -Namespace Win32 -PassThru
# $api::CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, pUrlArray, pcbUrlArray, pUrlInfo, pcbUrlInfo, pvReserved)

#uselib "CRYPTNET.dll"
#func global CryptGetObjectUrl "CryptGetObjectUrl" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; CryptGetObjectUrl pszUrlOid, pvPara, dwFlags, varptr(pUrlArray), varptr(pcbUrlArray), varptr(pUrlInfo), varptr(pcbUrlInfo), pvReserved   ; 戻り値は stat
; pszUrlOid : LPCSTR -> "sptr"
; pvPara : void* -> "sptr"
; dwFlags : CRYPT_GET_URL_FLAGS -> "sptr"
; pUrlArray : CRYPT_URL_ARRAY* optional, out -> "sptr"
; pcbUrlArray : DWORD* in/out -> "sptr"
; pUrlInfo : CRYPT_URL_INFO* optional, out -> "sptr"
; pcbUrlInfo : DWORD* optional, in/out -> "sptr"
; pvReserved : void* optional -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "CRYPTNET.dll"
#cfunc global CryptGetObjectUrl "CryptGetObjectUrl" str, sptr, int, var, var, var, var, sptr
; res = CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, pUrlArray, pcbUrlArray, pUrlInfo, pcbUrlInfo, pvReserved)
; pszUrlOid : LPCSTR -> "str"
; pvPara : void* -> "sptr"
; dwFlags : CRYPT_GET_URL_FLAGS -> "int"
; pUrlArray : CRYPT_URL_ARRAY* optional, out -> "var"
; pcbUrlArray : DWORD* in/out -> "var"
; pUrlInfo : CRYPT_URL_INFO* optional, out -> "var"
; pcbUrlInfo : DWORD* optional, in/out -> "var"
; pvReserved : void* optional -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CRYPTNET.dll"
#cfunc global CryptGetObjectUrl "CryptGetObjectUrl" str, sptr, int, sptr, sptr, sptr, sptr, sptr
; res = CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, varptr(pUrlArray), varptr(pcbUrlArray), varptr(pUrlInfo), varptr(pcbUrlInfo), pvReserved)
; pszUrlOid : LPCSTR -> "str"
; pvPara : void* -> "sptr"
; dwFlags : CRYPT_GET_URL_FLAGS -> "int"
; pUrlArray : CRYPT_URL_ARRAY* optional, out -> "sptr"
; pcbUrlArray : DWORD* in/out -> "sptr"
; pUrlInfo : CRYPT_URL_INFO* optional, out -> "sptr"
; pcbUrlInfo : DWORD* optional, in/out -> "sptr"
; pvReserved : void* optional -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; BOOL CryptGetObjectUrl(LPCSTR pszUrlOid, void* pvPara, CRYPT_GET_URL_FLAGS dwFlags, CRYPT_URL_ARRAY* pUrlArray, DWORD* pcbUrlArray, CRYPT_URL_INFO* pUrlInfo, DWORD* pcbUrlInfo, void* pvReserved)
#uselib "CRYPTNET.dll"
#cfunc global CryptGetObjectUrl "CryptGetObjectUrl" str, intptr, int, var, var, var, var, intptr
; res = CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, pUrlArray, pcbUrlArray, pUrlInfo, pcbUrlInfo, pvReserved)
; pszUrlOid : LPCSTR -> "str"
; pvPara : void* -> "intptr"
; dwFlags : CRYPT_GET_URL_FLAGS -> "int"
; pUrlArray : CRYPT_URL_ARRAY* optional, out -> "var"
; pcbUrlArray : DWORD* in/out -> "var"
; pUrlInfo : CRYPT_URL_INFO* optional, out -> "var"
; pcbUrlInfo : DWORD* optional, in/out -> "var"
; pvReserved : void* optional -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; BOOL CryptGetObjectUrl(LPCSTR pszUrlOid, void* pvPara, CRYPT_GET_URL_FLAGS dwFlags, CRYPT_URL_ARRAY* pUrlArray, DWORD* pcbUrlArray, CRYPT_URL_INFO* pUrlInfo, DWORD* pcbUrlInfo, void* pvReserved)
#uselib "CRYPTNET.dll"
#cfunc global CryptGetObjectUrl "CryptGetObjectUrl" str, intptr, int, intptr, intptr, intptr, intptr, intptr
; res = CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, varptr(pUrlArray), varptr(pcbUrlArray), varptr(pUrlInfo), varptr(pcbUrlInfo), pvReserved)
; pszUrlOid : LPCSTR -> "str"
; pvPara : void* -> "intptr"
; dwFlags : CRYPT_GET_URL_FLAGS -> "int"
; pUrlArray : CRYPT_URL_ARRAY* optional, out -> "intptr"
; pcbUrlArray : DWORD* in/out -> "intptr"
; pUrlInfo : CRYPT_URL_INFO* optional, out -> "intptr"
; pcbUrlInfo : DWORD* optional, in/out -> "intptr"
; pvReserved : void* optional -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	cryptnet = windows.NewLazySystemDLL("CRYPTNET.dll")
	procCryptGetObjectUrl = cryptnet.NewProc("CryptGetObjectUrl")
)

// pszUrlOid (LPCSTR), pvPara (void*), dwFlags (CRYPT_GET_URL_FLAGS), pUrlArray (CRYPT_URL_ARRAY* optional, out), pcbUrlArray (DWORD* in/out), pUrlInfo (CRYPT_URL_INFO* optional, out), pcbUrlInfo (DWORD* optional, in/out), pvReserved (void* optional)
r1, _, err := procCryptGetObjectUrl.Call(
	uintptr(unsafe.Pointer(windows.BytePtrFromString(pszUrlOid))),
	uintptr(pvPara),
	uintptr(dwFlags),
	uintptr(pUrlArray),
	uintptr(pcbUrlArray),
	uintptr(pUrlInfo),
	uintptr(pcbUrlInfo),
	uintptr(pvReserved),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL

function CryptGetObjectUrl(
  pszUrlOid: PAnsiChar;   // LPCSTR
  pvPara: Pointer;   // void*
  dwFlags: DWORD;   // CRYPT_GET_URL_FLAGS
  pUrlArray: Pointer;   // CRYPT_URL_ARRAY* optional, out
  pcbUrlArray: Pointer;   // DWORD* in/out
  pUrlInfo: Pointer;   // CRYPT_URL_INFO* optional, out
  pcbUrlInfo: Pointer;   // DWORD* optional, in/out
  pvReserved: Pointer   // void* optional
): BOOL; stdcall;
  external 'CRYPTNET.dll' name 'CryptGetObjectUrl';

result := DllCall("CRYPTNET\CryptGetObjectUrl"
    , "AStr", pszUrlOid   ; LPCSTR
    , "Ptr", pvPara   ; void*
    , "UInt", dwFlags   ; CRYPT_GET_URL_FLAGS
    , "Ptr", pUrlArray   ; CRYPT_URL_ARRAY* optional, out
    , "Ptr", pcbUrlArray   ; DWORD* in/out
    , "Ptr", pUrlInfo   ; CRYPT_URL_INFO* optional, out
    , "Ptr", pcbUrlInfo   ; DWORD* optional, in/out
    , "Ptr", pvReserved   ; void* optional
    , "Int")   ; return: BOOL

●CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, pUrlArray, pcbUrlArray, pUrlInfo, pcbUrlInfo, pvReserved) = DLL("CRYPTNET.dll", "bool CryptGetObjectUrl(char*, void*, dword, void*, void*, void*, void*, void*)")
# 呼び出し: CryptGetObjectUrl(pszUrlOid, pvPara, dwFlags, pUrlArray, pcbUrlArray, pUrlInfo, pcbUrlInfo, pvReserved)
# pszUrlOid : LPCSTR -> "char*"
# pvPara : void* -> "void*"
# dwFlags : CRYPT_GET_URL_FLAGS -> "dword"
# pUrlArray : CRYPT_URL_ARRAY* optional, out -> "void*"
# pcbUrlArray : DWORD* in/out -> "void*"
# pUrlInfo : CRYPT_URL_INFO* optional, out -> "void*"
# pcbUrlInfo : DWORD* optional, in/out -> "void*"
# pvReserved : void* optional -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。