.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH CryptProtectData 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBCryptProtectData\fR (CRYPT32.@)
.SH SYNOPSIS
BOOL CryptProtectData
 (
  DATA_BLOB*                 \fIpDataIn\fR,
  LPCWSTR                    \fIszDataDescr\fR,
  DATA_BLOB*                 \fIpOptionalEntropy\fR,
  PVOID                      \fIpvReserved\fR,
  CRYPTPROTECT_PROMPTSTRUCT* \fIpPromptStruct\fR,
  DWORD                      \fIdwFlags\fR,
  DATA_BLOB*                 \fIpDataOut\fR
 )

.SH DESCRIPTION
.PP
Generate Cipher data from given Plain and Entropy data. 

.SH PARAMS
\fIpDataIn\fR \fB[In]\fR  Plain data to be enciphered.
.PP
\fIszDataDescr\fR \fB[In]\fR  Optional Unicode string describing the Plain data.
.PP
\fIpOptionalEntropy\fR \fB[In]\fR  Optional entropy data to adjust cipher, can be \fBNULL\fR.
.PP
\fIpvReserved\fR \fB[In]\fR  Reserved, must be \fBNULL\fR.
.PP
\fIpPromptStruct\fR \fB[In]\fR  Structure describing if/how to prompt during ciphering.
.PP
\fIdwFlags\fR \fB[In]\fR  Flags describing options to the ciphering.
.PP
\fIpDataOut\fR \fB[Out]\fR  Resulting Cipher data, for calls to CryptUnprotectData.
.PP

.SH RETURNS
.PP
\fBTRUE\fR If a Cipher was generated. \fBFALSE\fR If something failed and no Cipher is available. 

.SH FIXME
.PP
The \fBTRUE\fR Windows(tm) encryption and keying mechanisms are unknown. 
.PP
\fIdwFlags\fR and \fIpPromptStruct\fR are currently ignored. 

.SH NOTES
.PP
Memory allocated in \fIpDataOut\fR must be freed with LocalFree. 

.SH IMPLEMENTATION
.PP
Declared in \fB"wincrypt.h"\fR. 
.PP
Implemented in \fB"dlls/crypt32/protectdata.c"\fR. 
.PP
Debug channel \fB"crypt"\fR.