SslLookupCipherSuiteInfo-Funktion

Die SslLookupCipherSuiteInfo-Funktion ruft die Verschlüsselungssammlungsinformationen für ein angegebenes Protokoll, eine verschlüsselungssammlung und einen festgelegten Schlüsseltyp 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 die SSL-Protokollanbieterinstanz (Secure Sockets Layer Protocol).

dwProtocol [ In]

Einer der CNG SSL Provider Protocol Identifier-Werte.

dwCipherSuite [ In]

Einer der CNG SSL Provider Cipher Suite Identifiers-Werte.

dwKeyType [ In]

Einer der 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 0 (null) zurück.

Wenn die Funktion fehlschlägt, wird ein Fehlerwert ungleich 0 (null) zurückgegeben.

Mögliche Rückgabecodes sind u. a. folgende.

Rückgabecode/-wert Beschreibung
NTE _ UNGÜLTIGES _ HANDLE
0x80090026L
Das hSslProvider-Handle ist ungültig.

Anforderungen

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