SslGetProviderProperty-Funktion

Die SslGetProviderProperty-Funktion ruft den Wert einer angegebenen Anbietereigenschaft ab.

Syntax

SECURITY_STATUS WINAPI SslGetProviderProperty(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _In_    LPCWSTR            pszProperty,
  _Out_   PBYTE              ppbOutput,
  _Out_   DWORD              *pcbOutput,
  _Inout_ PVOID              *ppEnumState,
  _In_    DWORD              dwFlags
);

Parameter

hSslProvider [in]

Das Handle des SSL-Anbieters (Secure Sockets Layer-Protokoll ), für den die Eigenschaft abgerufen werden soll.

pszProperty [in]

Ein Zeiger auf eine unicode-Zeichenfolge mit Null-Beendigung, die den Namen der abzurufenden Eigenschaft enthält.

ppbOutput [out]

Die Adresse eines Puffers, der den Eigenschaftswert empfängt.

Der Aufrufer der Funktion muss diesen Puffer durch Aufrufen der SslFreeBuffer-Funktion freigeben.

pcbOutput [out]

Die Größe des pbOutput-Puffers in Bytes.

ppEnumState [in, out]

Die Adresse eines VOID-Zeigers , der Enumerationsstatusinformationen empfängt, die in nachfolgenden Aufrufen dieser Funktion verwendet werden. Diese Informationen haben nur eine Bedeutung für den SSL-Anbieter und sind für den Aufrufer undurchsichtig. Der SSL-Anbieter verwendet diese Informationen, um zu bestimmen, welches Element als Nächstes in der Enumeration angezeigt wird. Wenn die Variable, auf die dieser Parameter verweist, NULL enthält, wird die Enumeration von Anfang an gestartet.

Der Aufrufer der Funktion muss diesen Arbeitsspeicher durch Aufrufen der SslFreeBuffer-Funktion freigeben.

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_NO_MEMORY 0x8009000EL	Für die Zuweisung der erforderlichen Puffer steht nicht genügend Arbeitsspeicher zur Verfügung.
NTE_INVALID_HANDLE 0x80090026L	Das hSslProvider-Handle ist ungültig.
NTE_INVALID_PARAMETER 0x80090027L	Einer der angegebenen Parameter 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