SslOpenProvider function

The SslOpenProvider function opens a handle to the specified Secure Sockets Layer protocol (SSL) protocol provider.

Syntax


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

Parameters

phSslProvider [out]

The address of an NCRYPT_PROV_HANDLE in which to write the provider handle.

When you have finished using the handle, you should free it by calling the SslFreeObject function.

pszProviderName [in]

A pointer to a Unicode string that contains the provider name. If the value of this parameter is NULL, a handle to the MS_SCHANNEL_PROVIDER is returned.

dwFlags [in]

This parameter is reserved for future use, and it must be set to zero.

Return value

If the function succeeds, it returns zero.

If the function fails, it returns a nonzero error value.

Possible return codes include, but are not limited to, the following.

Return code/valueDescription
NTE_INVALID_HANDLE
0x80090026L

One of the provided handles is not valid.

NTE_INVALID_PARAMETER
0x80090027L

The phSslProvider or ppProviderList parameter is NULL.

STATUS_NO_MEMORY
0xC0000017L

Not enough memory is available to allocate necessary buffers.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Sslprovider.h

DLL

Ncrypt.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft