共用方式為

NCryptEnumStorageProviders 函式 (ncrypt.h)

  • 發行項

NCryptEnumStorageProviders 函式會取得已註冊密鑰儲存提供者的名稱。

語法

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

參數

[out] pdwProviderCount

要接收 ppProviderList 陣列中項目數目的 DWORD 位址。

[out] ppProviderList

要接收已註冊金鑰儲存提供者名稱數位的 NCryptProviderName 結構指標位址。 pdwProviderCount 參數所指向的變數會收到此陣列中的元素數目。

當不再需要此記憶體時，請將此指標傳遞至 NCryptFreeBuffer 函 式來釋放它。

[in] dwFlags

修改函式行為的旗標。 這可以是零 (0) 或下列值。

值 意義
NCRYPT_SILENT_FLAG
 要求金鑰服務提供者 (KSP) 不會顯示任何使用者介面。 如果提供者必須顯示要運作的UI，呼叫會失敗，KSP應該將 NTE_SILENT_CONTEXT 錯誤碼設定為最後一個錯誤。

傳回值

傳回狀態代碼，指出函式的成功或失敗。

可能的傳回碼包括但不限於下列專案。

傳回碼 Description
ERROR_SUCCESS
 函式成功。
NTE_BAD_FLAGS
 dwFlags 參數包含無效的值。
NTE_INVALID_PARAMETER
 一或多個參數無效。
NTE_NO_MEMORY
 發生記憶體配置失敗。

備註

服務不得從它的 StartService 函式呼叫此函式。 如果服務從其 StartService 函式呼叫此函式，可能會發生死結，而且服務可能會停止回應。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 ncrypt.h
程式庫 Ncrypt.lib
Dll Ncrypt.dll

另請參閱

NCryptFreeBuffer