CryptProtectData.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

CryptProtectData (CRYPT32.@)

SYNOPSIS

BOOL CryptProtectData
 (
  DATA_BLOB*                 pDataIn,
  LPCWSTR                    szDataDescr,
  DATA_BLOB*                 pOptionalEntropy,
  PVOID                      pvReserved,
  CRYPTPROTECT_PROMPTSTRUCT* pPromptStruct,
  DWORD                      dwFlags,
  DATA_BLOB*                 pDataOut
 )

DESCRIPTION

Generate Cipher data from given Plain and Entropy data.

PARAMS

pDataIn [In] Plain data to be enciphered.

szDataDescr [In] Optional Unicode string describing the Plain data.

pOptionalEntropy [In] Optional entropy data to adjust cipher, can be NULL.

pvReserved [In] Reserved, must be NULL.

pPromptStruct [In] Structure describing if/how to prompt during ciphering.

dwFlags [In] Flags describing options to the ciphering.

pDataOut [Out] Resulting Cipher data, for calls to CryptUnprotectData.

RETURNS

TRUE If a Cipher was generated. FALSE If something failed and no Cipher is available.

FIXME

The TRUE Windows(tm) encryption and keying mechanisms are unknown.

dwFlags and pPromptStruct are currently ignored.

NOTES

Memory allocated in pDataOut must be freed with LocalFree.

IMPLEMENTATION

Defined in "wincrypt.h".

Implemented in "dlls/crypt32/protectdata.c".

Debug channel "crypt".