CryptGetDefaultOIDDllList 函数 (wincrypt.h)

  • 项目

CryptGetDefaultOIDDllList 函数获取包含指定函数集和编码类型的注册默认对象标识符 (OID) 函数的 DLL 文件的名称列表。

语法

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

参数

[in] hFuncSet

以前通过调用 CryptInitOIDFunctionSet 获取的函数集句柄。

[in] dwEncodingType

指定要匹配的编码类型。 目前，仅使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;但是，将来可能会添加其他编码类型。 若要匹配当前两种编码类型，请使用：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

注意 需要证书或 消息编码类型 。 X509_ASN_ENCODING为默认值。 如果指示该类型，则使用该类型;否则，如果指示PKCS7_ASN_ENCODING类型，则使用该类型。
 

[out] pwszDllList

指向缓冲区的指针，用于接收零个或多个以 null 结尾的文件名的列表。 返回的列表以终止 NULL 字符结尾 。 例如，包含两个名称的列表可以是：

L“first.dll\0” L“second.dll\0” L“\0”

若要检索缓冲区必须保留的宽字符数，此参数可以为 NULL。 有关详细信息，请参阅 检索未知长度的数据。

[in, out] pcchDllList

指向 DWORD 的指针，指定 pwszDllList 参数指向的返回列表的大小（以宽字符为单位）。 函数返回时， pcchDllList 参数指向的变量包含缓冲区中存储的宽字符数。

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

返回值

如果函数成功，则函数) 返回非零 (TRUE 。

如果函数失败，它将返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。

此函数具有以下错误代码。

返回代码 说明
ERROR_MORE_DATA
 如果 pwszDllList 参数指定的缓冲区不够大，无法容纳返回的数据，该函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以宽字符为单位）存储在 pcchDllList 指向的变量中。

要求

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

另请参阅

OID 支持函数