共用方式為

SslOpenProvider 函式

  • 發行項

SslOpenProvider函式會開啟指定安全通訊端層通訊協定的控制碼， (SSL) 通訊協定提供者。

語法

SECURITY_STATUS WINAPI SslOpenProvider(
  _Out_ NCRYPT_PROV_HANDLE *phSslProvider,
  _In_  LPCWSTR            pszProviderName,
  _In_  DWORD              dwFlags
);

參數

phSslProvider [out]

要在其中寫入提供者控制碼 的NCRYPT_PROV_HANDLE 位址。

當您完成使用控制碼之後，您應該呼叫 SslFreeObject 函式來釋放它。

pszProviderName [in]

包含提供者名稱的 Unicode 字串指標。 如果此參數的值是 Null，則會傳回 MS_SCHANNEL_PROVIDER 的控制碼。

dwFlags [in]

此參數保留供日後使用，且必須設定為零。

傳回值

如果函式成功，則會傳回零。

如果函式失敗，它會傳回非零錯誤值。

可能的傳回碼包括但不限於下列各項。

傳回碼/值 Description
NTE_INVALID_HANDLE
0x80090026L
 其中一個提供的控制碼無效。
NTE_INVALID_PARAMETER
0x80090027L
 phSslProvider或ppProviderList參數為Null。
STATUS_NO_MEMORY
0xC0000017L
 記憶體不足，無法配置必要的緩衝區。

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
標頭
Sslprovider.h
DLL
Ncrypt.dll