Ukázkový program jazyka C: Použití CryptProtectData

Note

Rozsah a omezení rozhraní DPAPI:

• Ve výchozím nastavení šifruje data tak, CryptProtectData aby ho dešifruje jenom stejný uživatelský účet na stejném počítači . Pomocí příznaku CRYPTPROTECT_LOCAL_MACHINE povolte dešifrování libovolného uživatele na počítači.
• Rozhraní DPAPI nechrání přenášená data ani na počítačích. Pro scénáře s více počítači nebo více uživateli použijte DPAPI-NG (NCryptProtectSecret/NCryptUnprotectSecret) nebo CNG s explicitní správou klíčů.
• Pokud správce resetuje heslo uživatele (místo změny uživatelem), můžou se dříve chráněná data stát nedostupnou, pokud není zavedený záložní klíč pro obnovení nebo záložní klíč DPAPI.

Následující příklad šifruje a dešifruje data OBJEKT BLOB pomocí CryptProtectData a CryptUnprotectData.

Tento příklad znázorňuje následující úlohy a funkce CryptoAPI:

• Inicializace datové struktury CRYPTPROTECT_PROMPTSTRUCT
• Použití CryptProtectData k šifrování datového objektu BLOB.
• K dešifrování dat použijte CryptUnprotectData.
• Použití LocalFree k uvolnění přidělené paměti.

Tento příklad používá funkci MyHandleError. Kód této funkce je součástí ukázky. Kód pro tento a další pomocné funkce je také uveden v části Funkce pro obecné účely.

Následující příklad ukazuje ochranu dat.

#pragma comment(lib, "crypt32.lib")

#include <stdio.h>
#include <windows.h>
#include <Wincrypt.h>
#define MY_ENCODING_TYPE  (PKCS_7_ASN_ENCODING | X509_ASN_ENCODING)
void MyHandleError(char *s);

void main()
{

// Copyright (C) Microsoft.  All rights reserved.
// Encrypt data from DATA_BLOB DataIn to DATA_BLOB DataOut.
// Then decrypt to DATA_BLOB DataVerify.

//-------------------------------------------------------------------
// Declare and initialize variables.

DATA_BLOB DataIn;
DATA_BLOB DataOut;
DATA_BLOB DataVerify;
BYTE *pbDataInput =(BYTE *)"Hello world of data protection.";
DWORD cbDataInput = strlen((char *)pbDataInput)+1;
DataIn.pbData = pbDataInput;    
DataIn.cbData = cbDataInput;
CRYPTPROTECT_PROMPTSTRUCT PromptStruct;
LPWSTR pDescrOut = NULL;

//-------------------------------------------------------------------
//  Begin processing.

printf("The data to be encrypted is: %s\n",pbDataInput);

//-------------------------------------------------------------------
//  Initialize PromptStruct.

ZeroMemory(&PromptStruct, sizeof(PromptStruct));
PromptStruct.cbSize = sizeof(PromptStruct);
PromptStruct.dwPromptFlags = CRYPTPROTECT_PROMPT_ON_PROTECT;
PromptStruct.szPrompt = L"This is a user prompt.";

//-------------------------------------------------------------------
//  Begin protect phase.

if(CryptProtectData(
     &DataIn,
     L"This is the description string.", // A description string. 
     NULL,                               // Optional entropy
                                         // not used.
     NULL,                               // Reserved.
     &PromptStruct,                      // Pass a PromptStruct.
     0,
     &DataOut))
{
     printf("The encryption phase worked. \n");
}
else
{
    MyHandleError("Encryption error!");
}
//-------------------------------------------------------------------
//   Begin unprotect phase.

if (CryptUnprotectData(
        &DataOut,
        &pDescrOut,
        NULL,                 // Optional entropy
        NULL,                 // Reserved
        &PromptStruct,        // Optional PromptStruct
        0,
        &DataVerify))
{
     printf("The decrypted data is: %s\n", DataVerify.pbData);
     printf("The description of the data was: %S\n",pDescrOut);
}
else
{
    MyHandleError("Decryption error!");
}
//-------------------------------------------------------------------
// At this point, memcmp could be used to compare DataIn.pbData and 
// DataVerify.pbDate for equality. If the two functions worked
// correctly, the two byte strings are identical. 

//-------------------------------------------------------------------
//  Clean up.

LocalFree(pDescrOut);
LocalFree(DataOut.pbData);
LocalFree(DataVerify.pbData);
} // End of main

//-------------------------------------------------------------------
//  This example uses the function MyHandleError, a simple error
//  handling function, to print an error message to the  
//  standard error (stderr) file and exit the program. 
//  For most applications, replace this function with one 
//  that does more extensive error reporting.

void MyHandleError(char *s)
{
    fprintf(stderr,"An error occurred in running the program. \n");
    fprintf(stderr,"%s\n",s);
    fprintf(stderr, "Error number %x.\n", GetLastError());
    fprintf(stderr, "Program terminating. \n");
    exit(1);
} // End of MyHandleError