Freigeben über


NCryptStreamOpenToUnprotectEx-Funktion (ncryptprotect.h)

Öffnet ein Streamobjekt, das verwendet werden kann, um große Datenmengen mit demselben Schutzdeskriptor zu entschlüsseln, der für die Verschlüsselung verwendet wird. Rufen Sie NCryptStreamUpdate auf, um die Entschlüsselung durchzuführen. Um kleinere Nachrichten wie Schlüssel und Kennwörter zu entschlüsseln, rufen Sie NCryptUnprotectSecret auf.

Syntax

SECURITY_STATUS NCryptStreamOpenToUnprotectEx(
  [in]           NCRYPT_PROTECT_STREAM_INFO_EX *pStreamInfo,
                 DWORD                         dwFlags,
  [in, optional] HWND                          hWnd,
  [out]          NCRYPT_STREAM_HANDLE          *phStream
);

Parameter

[in] pStreamInfo

Ein Zeiger auf NCRYPT_PROTECT_STREAM_INFO_EX.

dwFlags

Nur die NCRYPT_SILENT_FLAG wird unterstützt.

[in, optional] hWnd

Ein Fensterhandle, das als übergeordnetes Element einer angezeigten Benutzeroberfläche verwendet werden soll.

[out] phStream

Empfängt einen Zeiger auf ein Streamhandle.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt. Mögliche Rückgabecodes sind u. a.:

  • ERROR_SUCCESS
  • NTE_INVALID_PARAMETER
  • NTE_BAD_FLAGS
  • NTE_BAD_DATA
  • NTE_NO_MEMORY
  • NTE_NOT_FOUND
  • NTE_NOT_SUPPORTED
  • NTE_INVALID_HANDLE
  • NTE_BAD_KEY
  • NTE_BAD_PROVIDER
  • NTE_BAD_TYPE
  • NTE_DECRYPTION_FAILURE

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile ncryptprotect.h
Bibliothek Ncrypt.lib
DLL Ncrypt.dll