CryptEnumProviderTypesW 函式 （wincrypt.h）
提供者類型包括PROV_RSA_FULL、PROV_RSA_SCHANNEL和PROV_DSS。
語法
BOOL CryptEnumProviderTypesW(
[in] DWORD dwIndex,
[in] DWORD *pdwReserved,
[in] DWORD dwFlags,
[out] DWORD *pdwProvType,
[out] LPWSTR szTypeName,
[in, out] DWORD *pcbTypeName
);
參數
[in] dwIndex
要列舉之下一個提供者類型的索引。
[in] pdwReserved
保留供日後使用，且必須 NULL。
[in] dwFlags
保留供日後使用，且必須是零。
[out] pdwProvType
指定列舉提供者類型的 DWORD 值位址。
[out] szTypeName
從列舉提供者類型接收數據的緩衝區指標。 這是字串，包括終止 NULL 字元。 某些提供者類型沒有顯示名稱，在此情況下不會傳回名稱，而且 指向的傳回值是零。
此參數可以 NULL，以取得記憶體配置之名稱的大小。 如需詳細資訊，請參閱 擷取未知長度的數據。
[in, out] pcbTypeName
DWORD 值的指標，指定 pszTypeName 參數所指向之緩衝區的大小，以位元組為單位。 當函式傳回時，DWORD 值會包含儲存或儲存在緩衝區中的位元組數目。 某些提供者類型沒有顯示名稱，在此情況下不會傳回名稱，而且 指向的傳回值是零。
傳回值
如果函式成功，則傳回值為非零值（TRUE）。
如果函式失敗，則傳回值為零 （FALSE）。 如需擴充錯誤資訊，請呼叫 getLastError
NTE 前面加上的錯誤碼是由所使用的特定 CSP 所產生。 以下是一些可能的錯誤碼。
| 傳回碼 | 描述 |
|---|---|
|
沒有其他專案可列舉。 |
|
操作系統記憶體不足。 |
|
dwFlags 參數具有無法辨識的值。 |
|
類型註冊發生錯誤。 |
言論
此函式會列舉計算機上可用的提供者類型。 您可以使用 cryptEnumProviders 來列舉任何特定提供者類型的提供者。
例子
下列範例示範迴圈，其中列出所有可用的密碼編譯服務提供者類型。
#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 dwIndex;
DWORD dwType;
DWORD cbName;
LPTSTR pszName;
//--------------------------------------------------------------
// Print header lines for provider types.
printf("Listing Available Provider Types:\n");
printf("Provider type\tProvider Type Name\n");
printf("_____________\t_____________________________________\n");
// Loop through enumerating provider types.
dwIndex = 0;
while(CryptEnumProviderTypes(
dwIndex,
NULL,
0,
&dwType,
NULL,
&cbName
))
{
//-----------------------------------------------------------
// cbName returns the length of the name of the next
// provider type. 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 type name.
if (CryptEnumProviderTypes(
dwIndex++,
NULL,
NULL,
&dwType,
pszName,
&cbName))
{
printf (" %4.0d\t%s\n",dwType, pszName);
}
else
{
printf("ERROR - CryptEnumProviderTypes\n");
exit(1);
}
LocalFree(pszName);
} // End of while loop.
}
如需使用 CryptEnumProviderTypes 函式的另一個範例，請參閱 範例 C 程式：列舉 CSP 提供者和提供者類型。
注意
wincrypt.h 標頭會根據 UNICODE 預處理器常數的定義，將 CryptEnumProviderTypes 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | wincrypt.h |
| 連結庫 | Advapi32.lib |
| DLL | Advapi32.dll |