SslLookupCipherSuiteInfo function

The SslLookupCipherSuiteInfo function retrieves the cipher suite information for a specified protocol, cipher suite, and key type set.

Syntax


SECURITY_STATUS WINAPI SslLookupCipherSuiteInfo(
  _In_   NCRYPT_PROV_HANDLE hSslProvider,
  _In_   DWORD dwProtocol,
  _In_   DWORD dwCipherSuite,
  _In_   DWORD dwKeyType,
  _Out_  NCRYPT_SSL_CIPHER_SUITE *pCipherSuite,
  _In_   DWORD dwFlags
);

Parameters

hSslProvider [in]

The handle to the Secure Sockets Layer protocol (SSL) protocol provider instance.

dwProtocol [in]

One of the CNG SSL Provider Protocol Identifier values.

dwCipherSuite [in]

One of the CNG SSL Provider Cipher Suite Identifiers values.

dwKeyType [in]

One of the CNG SSL Provider Key Type Identifiers values.

pCipherSuite [out]

The address of a buffer that contains a NCRYPT_SSL_CIPHER_SUITE structure in which to write the cipher suite information.

dwFlags [in]

This parameter is reserved for future use.

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

The hSslProvider handle is not valid.

 

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:
© 2014 Microsoft