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

CTL_VERIFY_USAGE_STATUS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 48 バイト / x86: 28 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
cbSizeDWORD4+0+0この構造体のサイズ (バイト単位)。 CertVerifyCTLUsage を呼び出すアプリケーションがこのパラメーターを設定します。cbSize がこの構造体に必要なサイズ以上でない場合、CertVerifyCTLUsage は FALSE を返し、GetLastError は E_INVALIDARG を返します。
dwErrorDWORD4+4+4CertVerifyCTLUsage の呼び出しによって返されたエラー状態 (存在する場合)。取り得るエラー値の一覧については、CertVerifyCTLUsage の「戻り値」セクションを参照してください。
dwFlagsDWORD4+8+8CERT_VERIFY_UPDATED_CTL_FLAG が返された場合、CertVerifyCTLUsage は、有効期間が過ぎて有効でなくなった CTL を、期間が有効な新しい CTL に更新しました。
ppCtlCTL_CONTEXT**8/4+16+12

一致したサブジェクトを含む CTL コンテキストへのポインターへのポインター。呼び出し元のアプリケーションは、このポインターに NULL を設定して、サブジェクトを含む CTL を返さないことを示すことができます。

ppCtl が NULL でない場合、呼び出し元のアプリケーションは CertFreeCTLContext を使用して、返されたコンテキストを解放しなければなりません。

dwCtlEntryIndexDWORD4+24+16CTL の配列内で、一致したサブジェクトのエントリが格納されている配列位置を返します。
ppSignerCERT_CONTEXT**8/4+32+20

CTL の署名者の証明書コンテキストへのポインターへのポインター。呼び出し元のアプリケーションはこのポインターに NULL を設定して、CTL の署名者の証明書を返さないことを示すことができます。

ppSigner が NULL でない場合、呼び出し元のアプリケーションは CertFreeCTLContext を使用して、返されたコンテキストを解放しなければなりません。

dwSignerIndexDWORD4+40+24実際に使用された署名者のインデックス。メッセージに複数の署名者が存在する場合に必要です。

公式ドキュメント

CTL_VERIFY_USAGE_STATUS 構造体は、 CertVerifyCTLUsage によって返される 証明書信頼リスト (CTL) に関する情報を格納します。

解説(Remarks)

メンバー dwError、dwFlags、dwCtlEntryIndex、dwSignerIndex は、呼び出し元のアプリケーションが 0 に初期化する必要があります。

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

各言語での定義

#include <windows.h>

// CTL_VERIFY_USAGE_STATUS  (x64 48 / x86 28 バイト)
typedef struct CTL_VERIFY_USAGE_STATUS {
    DWORD cbSize;
    DWORD dwError;
    DWORD dwFlags;
    CTL_CONTEXT** ppCtl;
    DWORD dwCtlEntryIndex;
    CERT_CONTEXT** ppSigner;
    DWORD dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CTL_VERIFY_USAGE_STATUS
{
    public uint cbSize;
    public uint dwError;
    public uint dwFlags;
    public IntPtr ppCtl;
    public uint dwCtlEntryIndex;
    public IntPtr ppSigner;
    public uint dwSignerIndex;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CTL_VERIFY_USAGE_STATUS
    Public cbSize As UInteger
    Public dwError As UInteger
    Public dwFlags As UInteger
    Public ppCtl As IntPtr
    Public dwCtlEntryIndex As UInteger
    Public ppSigner As IntPtr
    Public dwSignerIndex As UInteger
End Structure
import ctypes
from ctypes import wintypes

class CTL_VERIFY_USAGE_STATUS(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwError", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("ppCtl", ctypes.c_void_p),
        ("dwCtlEntryIndex", wintypes.DWORD),
        ("ppSigner", ctypes.c_void_p),
        ("dwSignerIndex", wintypes.DWORD),
    ]
#[repr(C)]
pub struct CTL_VERIFY_USAGE_STATUS {
    pub cbSize: u32,
    pub dwError: u32,
    pub dwFlags: u32,
    pub ppCtl: *mut core::ffi::c_void,
    pub dwCtlEntryIndex: u32,
    pub ppSigner: *mut core::ffi::c_void,
    pub dwSignerIndex: u32,
}
import "golang.org/x/sys/windows"

type CTL_VERIFY_USAGE_STATUS struct {
	cbSize uint32
	dwError uint32
	dwFlags uint32
	ppCtl uintptr
	dwCtlEntryIndex uint32
	ppSigner uintptr
	dwSignerIndex uint32
}
type
  CTL_VERIFY_USAGE_STATUS = record
    cbSize: DWORD;
    dwError: DWORD;
    dwFlags: DWORD;
    ppCtl: Pointer;
    dwCtlEntryIndex: DWORD;
    ppSigner: Pointer;
    dwSignerIndex: DWORD;
  end;
const CTL_VERIFY_USAGE_STATUS = extern struct {
    cbSize: u32,
    dwError: u32,
    dwFlags: u32,
    ppCtl: ?*anyopaque,
    dwCtlEntryIndex: u32,
    ppSigner: ?*anyopaque,
    dwSignerIndex: u32,
};
type
  CTL_VERIFY_USAGE_STATUS {.bycopy.} = object
    cbSize: uint32
    dwError: uint32
    dwFlags: uint32
    ppCtl: pointer
    dwCtlEntryIndex: uint32
    ppSigner: pointer
    dwSignerIndex: uint32
struct CTL_VERIFY_USAGE_STATUS
{
    uint cbSize;
    uint dwError;
    uint dwFlags;
    void* ppCtl;
    uint dwCtlEntryIndex;
    void* ppSigner;
    uint dwSignerIndex;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CTL_VERIFY_USAGE_STATUS サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwError : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ppCtl : CTL_CONTEXT** (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; dwCtlEntryIndex : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ppSigner : CERT_CONTEXT** (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; dwSignerIndex : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CTL_VERIFY_USAGE_STATUS サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwError : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ppCtl : CTL_CONTEXT** (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; dwCtlEntryIndex : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ppSigner : CERT_CONTEXT** (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; dwSignerIndex : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global CTL_VERIFY_USAGE_STATUS
    #field int cbSize
    #field int dwError
    #field int dwFlags
    #field intptr ppCtl
    #field int dwCtlEntryIndex
    #field intptr ppSigner
    #field int dwSignerIndex
#endstruct

stdim st, CTL_VERIFY_USAGE_STATUS        ; NSTRUCT 変数を確保
st->cbSize = 100
mes "cbSize=" + st->cbSize