cryptFormatObject 函数 (wincrypt.h)

  • 项目

CryptFormatObject 函数格式化编码的数据，并根据证书编码类型在分配的缓冲区中返回 Unicode 字符串。

语法

BOOL CryptFormatObject(
  [in]      DWORD      dwCertEncodingType,
  [in]      DWORD      dwFormatType,
  [in]      DWORD      dwFormatStrType,
  [in]      void       *pFormatStruct,
  [in]      LPCSTR     lpszStructType,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [out]     void       *pbFormat,
  [in, out] DWORD      *pcbFormat
);

参数

[in] dwCertEncodingType

证书上使用的编码类型。 当前使用的证书编码类型为X509_ASN_ENCODING。

[in] dwFormatType

设置类型值的格式。 未使用。 设置为零。

[in] dwFormatStrType

结构格式类型值。 此参数可以为零，也可以使用按位 OR 运算符来指定以下一个或多个标志。

值 含义
0
 在单行中显示数据。 每个子字段都与逗号 (，) 连接在一起。 有关详细信息，请参阅“备注”。
CRYPT_FORMAT_STR_MULTI_LINE
0x0001
 在多行而不是单行 (默认) 显示数据。 有关详细信息，请参阅“备注”。
CRYPT_FORMAT_STR_NO_HEX
0x0010
 禁用十六进制转储。 有关详细信息，请参阅“备注”。

[in] pFormatStruct

指向 结构格式的指针。 未使用。 设置为 NULL。

[in] lpszStructType

指向定义编码数据的 OID 的指针。 如果 lpszStructType 参数的高位字为零，则低序字指定给定结构的类型的整数标识符。 否则，此参数是指向 以 null 结尾的字符串的长指针。

下表列出了支持的 OID 及其关联的 OID 扩展。

值 含义
SPC_FINANCIAL_CRITERIA_OBJID
 1.3.6.1.4.1.311.2.1.27
SPC_SP_AGENCY_INFO_OBJID
 1.3.6.1.4.1.311.2.1.10
szOID_AUTHORITY_INFO_ACCESS
 1.3.6.1.5.5.7.1.1
szOID_AUTHORITY_KEY_IDENTIFIER2
 2.5.29.35
szOID_BASIC_CONSTRAINTS2
 2.5.29.19
szOID_CERT_POLICIES
 2.5.29.32
szOID_CRL_DIST_POINTS
 2.5.29.31
szOID_CRL_REASON_CODE
 2.5.29.21
szOID_ENHANCED_KEY_USAGE
 2.5.29.37
szOID_ISSUER_ALT_NAME2
 2.5.29.18
szOID_KEY_ATTRIBUTES
 2.5.29.2
szOID_KEY_USAGE
 2.5.29.15
szOID_KEY_USAGE_RESTRICTION
 2.5.29.4
szOID_NEXT_UPDATE_LOCATION
 1.3.6.1.4.1.311.10.2
szOID_RSA_SMIMECapabilities
 1.2.840.113549.1.9.15
szOID_SUBJECT_ALT_NAME2
 2.5.29.17
szOID_SUBJECT_KEY_IDENTIFIER
 2.5.29.14

[in] pbEncoded

指向要设置格式的编码数据的指针。 如果 lpszStructType 是上面列出的 OID 之一，则 pbEncoded 是编码扩展。

[in] cbEncoded

pbEncoded 结构的大小（以字节为单位）。

[out] pbFormat

指向接收格式化字符串的缓冲区的指针。 当指定的缓冲区不够大，无法接收解码的结构时，函数将设置ERROR_MORE_DATA并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA format 指向的变量中。 此参数可以为 NULL ，用于设置此信息的大小，以便进行内存分配。 有关详细信息，请参阅 检索未知长度的数据。

[in, out] pcbFormat

指向变量的指针，该变量指定 pbFormat 参数指向的缓冲区的大小（以字节为单位）。 当函数返回时， 由参数所 指向的变量包含缓冲区中存储的字节数。 此参数可以为 NULL，仅当 pbFormat 为 NULL 时。

注意 处理缓冲区中返回的数据时，应用程序需要使用返回的数据的实际大小。 实际大小可能略小于输入时指定的缓冲区的大小。 (输入时，缓冲区大小通常指定得足够大，以确保最大可能的输出数据将适合 buffer。) 输出时，此参数指向的变量将更新，以反映复制到缓冲区的数据的实际大小。
 

返回值

如果函数成功，则返回值为 TRUE。 如果不成功，则返回值为 FALSE。 若要检索扩展的错误信息，请使用 GetLastError 函数。

注解

此函数的默认行为是返回编码数据的单行显示，即每个子字段与逗号 (，) 连接在一行上。 如果希望多行显示数据，请设置CRYPT_FORMAT_STR_MULTI_LINE标志。 然后，每个子字段将显示在单独的行上。

如果没有为 lpszStructType 参数安装或注册格式设置例程，则将返回编码 CRYPT_INTEGER_BLOB 的十六进制转储。 用户可以设置CRYPT_FORMAT_STR_NO_HEX标志以禁用十六进制转储。

要求

要求 值
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

另请参阅

CRYPT_INTEGER_BLOB