SslLookupCipherSuiteInfo-Funktion

Die SslLookupCipherSuiteInfo-Funktion ruft die Cipher Suite-Informationen für ein angegebenes Protokoll, eine angegebene Verschlüsselungssuite und einen angegebenen Schlüsseltypsatz ab.

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
);

Parameter

hSslProvider [in]

Das Handle für den SSL-Protokollanbieter (Secure Sockets Layer Protocol) instance.

dwProtocol [in]

Einer der Werte des CNG-SSL-Anbieterprotokoll-Bezeichners .

dwCipherSuite [in]

Einer der Werte für CNG SSL Provider Cipher Suite Identifiers .

dwKeyType [in]

Einer der Werte für Schlüsseltypbezeichner des CNG-SSL-Anbieters .

pCipherSuite [out]

Die Adresse eines Puffers, der eine NCRYPT_SSL_CIPHER_SUITE Struktur enthält, in die die Verschlüsselungssammlungsinformationen geschrieben werden sollen.

dwFlags [in]

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie null zurück.

Wenn die Funktion fehlschlägt, gibt sie einen fehlerfreien Wert zurück.

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode/-wert	Beschreibung
NTE_INVALID_HANDLE 0x80090026L	Das hSslProvider-Handle ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Sslprovider.h
DLL	Ncrypt.dll