Skip to content
Standard libraryZig 0.17.0Official documentation
Sourcestd/os/windows/crypt32.zig

Source line 1

std.os.windows.crypt32.BOOL

alias

Source line 4

Alias of std.os.windows.BOOL

std.os.windows.crypt32.BYTE

alias

Source line 6

Alias of std.os.windows.BYTE

std.os.windows.crypt32.CERT_CHAIN

container

Source line 166

Fields

CACHE_END_CERT: bool = false
THREAD_STORE_SYNC: bool = false
CACHE_ONLY_URL_RETRIEVAL: bool = false
USE_LOCAL_MACHINE_STORE: bool = false
ENABLE_CACHE_AUTO_UPDATE: bool = false
ENABLE_SHARE_STORE: bool = false
Reserved6: u20 = 0
REVOCATION_CHECK_OCSP_CERT: bool = false
REVOCATION_ACCUMULATIVE_TIMEOUT: bool = false
REVOCATION_CHECK_END_CERT: bool = false
REVOCATION_CHECK_CHAIN: bool = false
REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT: bool = false
REVOCATION_CHECK_CACHE_ONLY: bool = false

std.os.windows.crypt32.CERT_CHAIN.CONTEXT

container

Source line 181

std.os.windows.crypt32.CERT_CHAIN.PARA

container

Source line 190

Fields

cbSize: DWORD = @sizeOf(PARA)
RequestedUsage: USAGE_MATCH

std.os.windows.crypt32.CERT_CHAIN.POLICY

container

Source line 195

Fields

BASE = 1
AUTHENTICODE = 2
AUTHENTICODE_TS = 3
SSL = 4
BASIC_CONSTRAINTS = 5
NT_AUTH = 6
MICROSOFT_ROOT = 7
EV = 8
SSL_F12 = 9
SSL_HPKP_HEADER = 10
THIRD_PARTY_ROOT = 11
SSL_KEY_PIN = 12
CT = 13
_

LPCSTR

std.os.windows.crypt32.CERT_CHAIN.POLICY.FLAG

container

Source line 230

Fields

IGNORE_NOT_TIME_VALID: bool = false
IGNORE_CTL_NOT_TIME_VALID: bool = false
IGNORE_NOT_TIME_NESTED: bool = false
IGNORE_INVALID_BASIC_CONSTRAINTS: bool = false
ALLOW_UNKNOWN_CA: bool = false
IGNORE_WRONG_USAGE: bool = false
IGNORE_INVALID_NAME: bool = false
IGNORE_INVALID_POLICY: bool = false
IGNORE_END_REV_UNKNOWN: bool = false
IGNORE_CTL_SIGNER_REV_UNKNOWN: bool = false
IGNORE_CA_REV_UNKNOWN: bool = false
IGNORE_ROOT_REV_UNKNOWN: bool = false
IGNORE_PEER_TRUST: bool = false
IGNORE_NOT_SUPPORTED_CRITICAL_EXT: bool = false
TRUST_TESTROOT: bool = false
ALLOW_TESTROOT: bool = false
Reserved16: u11 = 0
IGNORE_WEAK_SIGNATURE: bool = false
Reserved28: u4 = 0

std.os.windows.crypt32.CERT_CHAIN.POLICY.fromString

function

Source line 212

pub fn fromString(str: LPCSTR) POLICY

Parameters

str: LPCSTR

std.os.windows.crypt32.CERT_CHAIN.POLICY.PARA

container

Source line 216

Fields

cbSize: DWORD = @sizeOf(POLICY.PARA)
dwFlags: FLAG
pvExtraPolicyPara: ?*anyopaque

std.os.windows.crypt32.CERT_CHAIN.POLICY.STATUS

container

Source line 222

Fields

cbSize: DWORD = @sizeOf(STATUS)
dwError: windows.Win32Error
lChainIndex: LONG
lElementIndex: LONG
pvExtraPolicyStatus: ?*anyopaque

std.os.windows.crypt32.CERT_CHAIN.USAGE_MATCH

container

Source line 183

Fields

dwType: TYPE
Usage: CERT_ENHKEY_USAGE

std.os.windows.crypt32.CERT_CHAIN.USAGE_MATCH.TYPE

container

Source line 187

Fields

AND = 0x00000000
OR = 0x00000001
_

std.os.windows.crypt32.CERT_CLOSE_STORE_FLAG

container

Source line 120

Fields

FORCE: bool = false
CHECK: bool = false
Reserved2: u30 = 0

std.os.windows.crypt32.CERT_CONTEXT

container

Source line 40

Fields

dwCertEncodingType: ENCODING.TYPE
pbCertEncoded: [*]BYTE
cbCertEncoded: DWORD
pCertInfo: CERT_INFO
hCertStore: HCERTSTORE

std.os.windows.crypt32.CERT_ENHKEY_USAGE

alias

Source line 24

Alias of std.os.windows.crypt32.CTL_USAGE

std.os.windows.crypt32.CERT_INFO

type

Source line 17

std.os.windows.crypt32.CERT_STORE

namespace

Source line 48

std.os.windows.crypt32.CERT_STORE.ADD

container

Source line 100

Fields

NEW = 1
USE_EXISTING = 2
REPLACE_EXISTING = 3
ALWAYS = 4
REPLACE_EXISTING_INHERIT_PROPERTIES = 5
REWER = 6
NEWER_INHERIT_PROPERTIES = 7
_

std.os.windows.crypt32.CERT_STORE.FLAG

container

Source line 80

Fields

NO_CRYPT_RELEASE: bool = false
SET_LOCALIZED_NAME: bool = false
DEFER_CLOSE_UNTIL_LAST_FREE: bool = false
Reserved3: u1 = 0
DELETE: bool = false
UNSAFE_PHYSICAL: bool = false
SHARE_STORE: bool = false
SHARE_CONTEXT: bool = false
MANIFOLD: bool = false
ENUM_ARCHIVED: bool = false
UPDATE_KEYID: bool = false
BACKUP_RESTORE: bool = false
MAXIMUM_ALLOWED: bool = false
CREATE_NEW: bool = false
OPEN_EXISTING: bool = false
READONLY: bool = false
Reserved16: u16 = 0

std.os.windows.crypt32.CERT_STORE.PROV

container

Source line 49

Fields

MSG = 1
MEMORY = 2
FILE = 3
REG = 4
PKCS7 = 5
SERIALIZED = 6
FILENAME_A = 7
FILENAME_W = 8
SYSTEM_A = 9
SYSTEM_W = 10
COLLECTION = 11
SYSTEM_REGISTRY_A = 12
SYSTEM_REGISTRY_W = 13
PHYSICAL_W = 14
SMART_CARD_W = 15
LDAP_W = 16
PKCS12 = 17
_

LPCSTR

std.os.windows.crypt32.CERT_STORE.PROV.fromString

function

Source line 75

pub fn fromString(str: LPCSTR) PROV

Parameters

str: LPCSTR

std.os.windows.crypt32.CertAddEncodedCertificateToStore

function

Source line 140

pub extern "crypt32" fn CertAddEncodedCertificateToStore( hCertStore: ?HCERTSTORE, dwCertEncodingType: ENCODING.TYPE, pbCertEncoded: [*]const BYTE, cbCertEncoded: DWORD, dwAddDisposition: CERT_STORE.ADD, ppCertContext: ?*?*const CERT_CONTEXT, ) callconv(.winapi) BOOL

Parameters

hCertStore: ?HCERTSTORE
dwCertEncodingType: ENCODING.TYPE
pbCertEncoded: [*]const BYTE
cbCertEncoded: DWORD
dwAddDisposition: CERT_STORE.ADD
ppCertContext: ?*?*const CERT_CONTEXT

std.os.windows.crypt32.CertCloseStore

function

Source line 126

pub extern "crypt32" fn CertCloseStore( hCertStore: HCERTSTORE, dwFlags: CERT_CLOSE_STORE_FLAG, ) callconv(.winapi) BOOL

Parameters

hCertStore: HCERTSTORE
dwFlags: CERT_CLOSE_STORE_FLAG

std.os.windows.crypt32.CertEnumCertificatesInStore

function

Source line 131

pub extern "crypt32" fn CertEnumCertificatesInStore( hCertStore: HCERTSTORE, pPrevCertContext: ?*CERT_CONTEXT, ) callconv(.winapi) ?*CERT_CONTEXT

Parameters

hCertStore: HCERTSTORE
pPrevCertContext: ?*CERT_CONTEXT

std.os.windows.crypt32.CertFreeCertificateChain

function

Source line 274

pub extern "crypt32" fn CertFreeCertificateChain( pChainContext: *const CERT_CHAIN.CONTEXT, ) callconv(.winapi) void

Parameters

pChainContext: *const CERT_CHAIN.CONTEXT

std.os.windows.crypt32.CertFreeCertificateContext

function

Source line 136

pub extern "crypt32" fn CertFreeCertificateContext( pCertContext: ?*const CERT_CONTEXT, ) callconv(.winapi) BOOL

Parameters

pCertContext: ?*const CERT_CONTEXT

std.os.windows.crypt32.CertGetCertificateChain

function

Source line 263

pub extern "crypt32" fn CertGetCertificateChain( hChainEngine: HCERTCHAINENGINE, pCertContext: *const CERT_CONTEXT, pTime: ?*const FILETIME, hAdditionalStore: ?HCERTSTORE, pChainPara: *const CERT_CHAIN.PARA, dwFlags: CERT_CHAIN, pvReserved: ?*const anyopaque, ppChainContext: **const CERT_CHAIN.CONTEXT, ) callconv(.winapi) BOOL

Parameters

hChainEngine: HCERTCHAINENGINE
pCertContext: *const CERT_CONTEXT
pTime: ?*const FILETIME
hAdditionalStore: ?HCERTSTORE
pChainPara: *const CERT_CHAIN.PARA
dwFlags: CERT_CHAIN
pvReserved: ?*const anyopaque
ppChainContext: **const CERT_CHAIN.CONTEXT

std.os.windows.crypt32.CertOpenStore

function

Source line 112

pub extern "crypt32" fn CertOpenStore( lpszStoreProvider: CERT_STORE.PROV, dwEncodingType: ENCODING.TYPE, hCryptProv: HCRYPTPROV_LEGACY, dwFlags: CERT_STORE.FLAG, pvPara: ?*const anyopaque, ) callconv(.winapi) ?HCERTSTORE

Parameters

lpszStoreProvider: CERT_STORE.PROV
dwEncodingType: ENCODING.TYPE
hCryptProv: HCRYPTPROV_LEGACY
dwFlags: CERT_STORE.FLAG
pvPara: ?*const anyopaque

std.os.windows.crypt32.CertOpenSystemStoreW

function

Source line 149

pub extern "crypt32" fn CertOpenSystemStoreW( hProv: HCRYPTPROV_LEGACY, szSubsystemProtocol: LPCWSTR, ) callconv(.winapi) ?HCERTSTORE

Parameters

hProv: HCRYPTPROV_LEGACY
szSubsystemProtocol: LPCWSTR

std.os.windows.crypt32.CertVerifyCertificateChainPolicy

function

Source line 278

pub extern "crypt32" fn CertVerifyCertificateChainPolicy( pszPolicyOID: CERT_CHAIN.POLICY, pChainContext: *const CERT_CHAIN.CONTEXT, pPolicyPara: *const CERT_CHAIN.POLICY.PARA, pPolicyStatus: *CERT_CHAIN.POLICY.STATUS, ) callconv(.winapi) BOOL

Parameters

pszPolicyOID: CERT_CHAIN.POLICY
pChainContext: *const CERT_CHAIN.CONTEXT
pPolicyPara: *const CERT_CHAIN.POLICY.PARA
pPolicyStatus: *CERT_CHAIN.POLICY.STATUS

std.os.windows.crypt32.CTL_USAGE

container

Source line 19

Fields

cUsageIdentifier: DWORD
rgpszUsageIdentifier: [*]const LPCSTR

std.os.windows.crypt32.DWORD

alias

Source line 5

Alias of std.os.windows.DWORD

std.os.windows.crypt32.ENCODING

container

Source line 26

Fields

UNSPECIFIED = 0x0000
ASN = 0x0001
NDR = 0x0002
_

std.os.windows.crypt32.ENCODING.TYPE

container

Source line 32

Fields

CERT: ENCODING = .UNSPECIFIED
CMSG: ENCODING = .UNSPECIFIED

std.os.windows.crypt32.FILETIME

alias

Source line 10

Alias of std.os.windows.FILETIME

std.os.windows.crypt32.HANDLE

alias

Source line 11

Alias of std.os.windows.HANDLE

std.os.windows.crypt32.HCERTCHAINENGINE

container

Source line 154

Fields

CURRENT_USER = 0x0
LOCAL_MACHINE = 0x1
SERIAL_LOCAL_MACHINE = 0x2
_

HANDLE

std.os.windows.crypt32.HCERTCHAINENGINE.fromHandle

function

Source line 161

pub fn fromHandle(handle: HANDLE) HCERTCHAINENGINE

Parameters

handle: HANDLE

std.os.windows.crypt32.HCERTSTORE

type

Source line 38

std.os.windows.crypt32.HCRYPTPROV_LEGACY

container

Source line 15

Fields

NULL = 0

std.os.windows.crypt32.HTTPSPolicyCallbackData

container

Source line 254

Fields

cbSize: DWORD = @sizeOf(HTTPSPolicyCallbackData)
dwAuthType: AUTHTYPE
fdwChecks: DWORD = 0
pwszServerName: ?LPCWSTR = null

std.os.windows.crypt32.HTTPSPolicyCallbackData.AUTHTYPE

container

Source line 260

Fields

CLIENT = 1
SERVER = 2
_

std.os.windows.crypt32.LONG

alias

Source line 7

Alias of std.os.windows.LONG

std.os.windows.crypt32.LPCSTR

alias

Source line 8

Alias of std.os.windows.LPCSTR

std.os.windows.crypt32.LPCWSTR

alias

Source line 9

Alias of std.os.windows.LPCWSTR

std.os.windows.crypt32.std

alias

Source line 1

Alias of std

std.os.windows.crypt32.windows

alias

Source line 2

Alias of std.os.windows

Source code

std/os/windows/crypt32.zig

const std = @import("../../std.zig");
const windows = std.os.windows;

const BOOL = windows.BOOL;
const DWORD = windows.DWORD;
const BYTE = windows.BYTE;
const LONG = windows.LONG;
const LPCSTR = windows.LPCSTR;
const LPCWSTR = windows.LPCWSTR;
const FILETIME = windows.FILETIME;
const HANDLE = windows.HANDLE;

// ref: um/wincrypt.h

pub const HCRYPTPROV_LEGACY = enum(usize) { NULL = 0 };

pub const CERT_INFO = *opaque {};

pub const CTL_USAGE = extern struct {
    cUsageIdentifier: DWORD,
    rgpszUsageIdentifier: [*]const LPCSTR,
};

pub const CERT_ENHKEY_USAGE = CTL_USAGE;

pub const ENCODING = enum(u16) {
    UNSPECIFIED = 0x0000,
    ASN = 0x0001,
    NDR = 0x0002,
    _,

    pub const TYPE = packed struct(DWORD) {
        CERT: ENCODING = .UNSPECIFIED,
        CMSG: ENCODING = .UNSPECIFIED,
    };
};

pub const HCERTSTORE = *opaque {};

pub const CERT_CONTEXT = extern struct {
    dwCertEncodingType: ENCODING.TYPE,
    pbCertEncoded: [*]BYTE,
    cbCertEncoded: DWORD,
    pCertInfo: CERT_INFO,
    hCertStore: HCERTSTORE,
};

pub const CERT_STORE = struct {
    pub const PROV = enum(usize) {
        MSG = 1,
        MEMORY = 2,
        FILE = 3,
        REG = 4,

        PKCS7 = 5,
        SERIALIZED = 6,
        FILENAME_A = 7,
        FILENAME_W = 8,
        SYSTEM_A = 9,
        SYSTEM_W = 10,

        COLLECTION = 11,
        SYSTEM_REGISTRY_A = 12,
        SYSTEM_REGISTRY_W = 13,
        PHYSICAL_W = 14,

        SMART_CARD_W = 15,

        LDAP_W = 16,
        PKCS12 = 17,

        /// LPCSTR
        _,

        pub fn fromString(str: LPCSTR) PROV {
            return @fromBackingInt(@intCast(@intFromPtr(str)));
        }
    };

    pub const FLAG = packed struct(DWORD) {
        NO_CRYPT_RELEASE: bool = false,
        SET_LOCALIZED_NAME: bool = false,
        DEFER_CLOSE_UNTIL_LAST_FREE: bool = false,
        Reserved3: u1 = 0,
        DELETE: bool = false,
        UNSAFE_PHYSICAL: bool = false,
        SHARE_STORE: bool = false,
        SHARE_CONTEXT: bool = false,
        MANIFOLD: bool = false,
        ENUM_ARCHIVED: bool = false,
        UPDATE_KEYID: bool = false,
        BACKUP_RESTORE: bool = false,
        MAXIMUM_ALLOWED: bool = false,
        CREATE_NEW: bool = false,
        OPEN_EXISTING: bool = false,
        READONLY: bool = false,
        Reserved16: u16 = 0,
    };

    pub const ADD = enum(DWORD) {
        NEW = 1,
        USE_EXISTING = 2,
        REPLACE_EXISTING = 3,
        ALWAYS = 4,
        REPLACE_EXISTING_INHERIT_PROPERTIES = 5,
        REWER = 6,
        NEWER_INHERIT_PROPERTIES = 7,
        _,
    };
};

pub extern "crypt32" fn CertOpenStore(
    lpszStoreProvider: CERT_STORE.PROV,
    dwEncodingType: ENCODING.TYPE,
    hCryptProv: HCRYPTPROV_LEGACY,
    dwFlags: CERT_STORE.FLAG,
    pvPara: ?*const anyopaque,
) callconv(.winapi) ?HCERTSTORE;

pub const CERT_CLOSE_STORE_FLAG = packed struct(DWORD) {
    FORCE: bool = false,
    CHECK: bool = false,
    Reserved2: u30 = 0,
};

pub extern "crypt32" fn CertCloseStore(
    hCertStore: HCERTSTORE,
    dwFlags: CERT_CLOSE_STORE_FLAG,
) callconv(.winapi) BOOL;

pub extern "crypt32" fn CertEnumCertificatesInStore(
    hCertStore: HCERTSTORE,
    pPrevCertContext: ?*CERT_CONTEXT,
) callconv(.winapi) ?*CERT_CONTEXT;

pub extern "crypt32" fn CertFreeCertificateContext(
    pCertContext: ?*const CERT_CONTEXT,
) callconv(.winapi) BOOL;

pub extern "crypt32" fn CertAddEncodedCertificateToStore(
    hCertStore: ?HCERTSTORE,
    dwCertEncodingType: ENCODING.TYPE,
    pbCertEncoded: [*]const BYTE,
    cbCertEncoded: DWORD,
    dwAddDisposition: CERT_STORE.ADD,
    ppCertContext: ?*?*const CERT_CONTEXT,
) callconv(.winapi) BOOL;

pub extern "crypt32" fn CertOpenSystemStoreW(
    hProv: HCRYPTPROV_LEGACY,
    szSubsystemProtocol: LPCWSTR,
) callconv(.winapi) ?HCERTSTORE;

pub const HCERTCHAINENGINE = enum(usize) {
    CURRENT_USER = 0x0,
    LOCAL_MACHINE = 0x1,
    SERIAL_LOCAL_MACHINE = 0x2,
    /// HANDLE
    _,

    pub fn fromHandle(handle: HANDLE) HCERTCHAINENGINE {
        return @fromBackingInt(@intCast(@intFromPtr(handle)));
    }
};

pub const CERT_CHAIN = packed struct(DWORD) {
    CACHE_END_CERT: bool = false,
    THREAD_STORE_SYNC: bool = false,
    CACHE_ONLY_URL_RETRIEVAL: bool = false,
    USE_LOCAL_MACHINE_STORE: bool = false,
    ENABLE_CACHE_AUTO_UPDATE: bool = false,
    ENABLE_SHARE_STORE: bool = false,
    Reserved6: u20 = 0,
    REVOCATION_CHECK_OCSP_CERT: bool = false,
    REVOCATION_ACCUMULATIVE_TIMEOUT: bool = false,
    REVOCATION_CHECK_END_CERT: bool = false,
    REVOCATION_CHECK_CHAIN: bool = false,
    REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT: bool = false,
    REVOCATION_CHECK_CACHE_ONLY: bool = false,

    pub const CONTEXT = opaque {};

    pub const USAGE_MATCH = extern struct {
        dwType: TYPE,
        Usage: CERT_ENHKEY_USAGE,

        pub const TYPE = enum(DWORD) { AND = 0x00000000, OR = 0x00000001, _ };
    };

    pub const PARA = extern struct {
        cbSize: DWORD = @sizeOf(PARA),
        RequestedUsage: USAGE_MATCH,
    };

    pub const POLICY = enum(usize) {
        BASE = 1,
        AUTHENTICODE = 2,
        AUTHENTICODE_TS = 3,
        SSL = 4,
        BASIC_CONSTRAINTS = 5,
        NT_AUTH = 6,
        MICROSOFT_ROOT = 7,
        EV = 8,
        SSL_F12 = 9,
        SSL_HPKP_HEADER = 10,
        THIRD_PARTY_ROOT = 11,
        SSL_KEY_PIN = 12,
        CT = 13,
        /// LPCSTR
        _,

        pub fn fromString(str: LPCSTR) POLICY {
            return @fromBackingInt(@intCast(@intFromPtr(str)));
        }

        pub const PARA = extern struct {
            cbSize: DWORD = @sizeOf(POLICY.PARA),
            dwFlags: FLAG,
            pvExtraPolicyPara: ?*anyopaque,
        };

        pub const STATUS = extern struct {
            cbSize: DWORD = @sizeOf(STATUS),
            dwError: windows.Win32Error,
            lChainIndex: LONG,
            lElementIndex: LONG,
            pvExtraPolicyStatus: ?*anyopaque,
        };

        pub const FLAG = packed struct(DWORD) {
            IGNORE_NOT_TIME_VALID: bool = false,
            IGNORE_CTL_NOT_TIME_VALID: bool = false,
            IGNORE_NOT_TIME_NESTED: bool = false,
            IGNORE_INVALID_BASIC_CONSTRAINTS: bool = false,
            ALLOW_UNKNOWN_CA: bool = false,
            IGNORE_WRONG_USAGE: bool = false,
            IGNORE_INVALID_NAME: bool = false,
            IGNORE_INVALID_POLICY: bool = false,
            IGNORE_END_REV_UNKNOWN: bool = false,
            IGNORE_CTL_SIGNER_REV_UNKNOWN: bool = false,
            IGNORE_CA_REV_UNKNOWN: bool = false,
            IGNORE_ROOT_REV_UNKNOWN: bool = false,
            IGNORE_PEER_TRUST: bool = false,
            IGNORE_NOT_SUPPORTED_CRITICAL_EXT: bool = false,
            TRUST_TESTROOT: bool = false,
            ALLOW_TESTROOT: bool = false,
            Reserved16: u11 = 0,
            IGNORE_WEAK_SIGNATURE: bool = false,
            Reserved28: u4 = 0,
        };
    };
};

pub const HTTPSPolicyCallbackData = extern struct {
    cbSize: DWORD = @sizeOf(HTTPSPolicyCallbackData),
    dwAuthType: AUTHTYPE,
    fdwChecks: DWORD = 0,
    pwszServerName: ?LPCWSTR = null,

    pub const AUTHTYPE = enum(DWORD) { CLIENT = 1, SERVER = 2, _ };
};

pub extern "crypt32" fn CertGetCertificateChain(
    hChainEngine: HCERTCHAINENGINE,
    pCertContext: *const CERT_CONTEXT,
    pTime: ?*const FILETIME,
    hAdditionalStore: ?HCERTSTORE,
    pChainPara: *const CERT_CHAIN.PARA,
    dwFlags: CERT_CHAIN,
    pvReserved: ?*const anyopaque,
    ppChainContext: **const CERT_CHAIN.CONTEXT,
) callconv(.winapi) BOOL;

pub extern "crypt32" fn CertFreeCertificateChain(
    pChainContext: *const CERT_CHAIN.CONTEXT,
) callconv(.winapi) void;

pub extern "crypt32" fn CertVerifyCertificateChainPolicy(
    pszPolicyOID: CERT_CHAIN.POLICY,
    pChainContext: *const CERT_CHAIN.CONTEXT,
    pPolicyPara: *const CERT_CHAIN.POLICY.PARA,
    pPolicyStatus: *CERT_CHAIN.POLICY.STATUS,
) callconv(.winapi) BOOL;