通过

CryptEnumProvidersA 函数 （wincrypt.h）

  • 项目
重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft可能会在将来的版本中删除此 API。
 
CryptEnumProviders 函数检索第一个或下一个可用的 加密服务提供商（CSP）。 在循环中使用，此函数可以按顺序检索计算机上可用的所有 CSP。

可能的 CSP 包括Microsoft基础加密提供程序版本 1.0 和Microsoft增强型加密提供程序版本 1.0。

语法

BOOL CryptEnumProvidersA(
  [in]      DWORD dwIndex,
  [in]      DWORD *pdwReserved,
  [in]      DWORD dwFlags,
  [out]     DWORD *pdwProvType,
  [out]     LPSTR szProvName,
  [in, out] DWORD *pcbProvName
);

参数

[in] dwIndex

要枚举的下一个提供程序的索引。

[in] pdwReserved

保留以供将来使用，必须 NULL。

[in] dwFlags

保留以供将来使用，且必须为零。

[out] pdwProvType

指定枚举提供程序类型的 DWORD 值的地址。

[out] szProvName

指向从枚举提供程序接收数据的缓冲区的指针。 这是一个字符串，包括终止 null 字符。

此参数可以 NULL，以便为内存分配设置名称的大小。 有关详细信息，请参阅 检索未知长度的数据。

[in, out] pcbProvName

指向 DWORD 值的指针，该值指定由 pszProvName 参数指向的缓冲区的大小（以字节为单位）。 函数返回时，DWORD 值包含缓冲区中存储的字节数。

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

返回值

如果函数成功，则返回值为非零（TRUE）。

如果函数失败，则返回值为零（FALSE）。 有关扩展错误信息，请调用 GetLastError。

NTE 前面带的错误代码由正在使用的特定 CSP 生成。 下面是一些可能的错误代码。

返回代码 描述
ERROR_MORE_DATA
 pszProvName 缓冲区不够大，无法容纳提供程序名称。
ERROR_NO_MORE_ITEMS
 无需再枚举任何项。
ERROR_NOT_ENOUGH_MEMORY
 操作系统内存不足。
NTE_BAD_FLAGS
 dwFlags 参数具有无法识别的值。
NTE_FAIL
 类型注册出现问题。

言论

此函数枚举计算机上可用的提供程序。 可以使用 CryptEnumProviderTypes枚举提供程序类型。

例子

以下示例显示了一个循环，其中列出了所有可用的加密服务提供程序。 有关使用 CryptEnumProviders 函数的另一个示例，请参阅 示例 C 程序：枚举 CSP 提供程序和提供程序类型。

#include <stdio.h>
#include <windows.h>
#include <Wincrypt.h>
#pragma comment(lib, "advapi32.lib")

void main()
{

    //---------------------------------------------------------------
    // Copyright (C) Microsoft.  All rights reserved.
    // Declare and initialize variables.

    DWORD       cbName;
    DWORD       dwType;
    DWORD       dwIndex;
    CHAR        *pszName = NULL; 

    // Print header lines for providers.
    printf("Listing Available Providers:\n");
    printf("Provider type\tProvider Name\n");
    printf("_____________\t__________________"
        "___________________\n");   

    //--------------------------------------------------------------- 
    // Loop through enumerating providers.
    dwIndex = 0;
    while(CryptEnumProviders(
           dwIndex,
           NULL,
           0,
           &dwType,
           NULL,
           &cbName
           ))
    {

        //-----------------------------------------------------------
        //  cbName returns the length of the name of the next 
        //  provider. Allocate memory in a buffer to retrieve 
        //  that name.

        if (!(pszName = (LPTSTR)LocalAlloc(LMEM_ZEROINIT, cbName)))
        {
           printf("ERROR - LocalAlloc failed\n");
           exit(1);
        }
        //-----------------------------------------------------------
        //  Get the provider name.
        if (CryptEnumProviders(
               dwIndex++,
               NULL,
               0,
               &dwType,
               pszName,
               &cbName
               ))
        {
            printf ("     %4.0d\t%s\n",dwType, pszName);
        }
        else
        {
            printf("ERROR - CryptEnumProviders failed.\n");
            exit(1);
        }
        LocalFree(pszName);

    } // End of while loop

    printf("\nProvider types and provider names "
        "have been listed.\n");
}

注意

wincrypt.h 标头将 CryptEnumProviders 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 wincrypt.h
库 Advapi32.lib
DLL Advapi32.dll

另请参阅

CryptEnumProviderTypes

服务提供程序函数