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.

Anforderungen