CryptUnprotectData 関数 (dpapi.h)

CryptUnprotectData 関数は、DATA_BLOB構造体内のデータの暗号化を解除し、整合性チェックを行います。 通常、データを復号化できる唯一のユーザーは、データを暗号化したユーザーと同じログオン 資格情報 を持つユーザーです。 さらに、暗号化と暗号化解除は、同じコンピューターで行う必要があります。 例外の詳細については、 CryptProtectData の「解説」セクションを参照してください。

構文

DPAPI_IMP BOOL CryptUnprotectData(
  [in]            DATA_BLOB                 *pDataIn,
  [out, optional] LPWSTR                    *ppszDataDescr,
  [in, optional]  DATA_BLOB                 *pOptionalEntropy,
                  PVOID                     pvReserved,
  [in, optional]  CRYPTPROTECT_PROMPTSTRUCT *pPromptStruct,
  [in]            DWORD                     dwFlags,
  [out]           DATA_BLOB                 *pDataOut
);

パラメーター

[in] pDataIn

暗号化されたデータを保持する DATA_BLOB 構造体へのポインター。 DATA_BLOB構造体の cbData メンバーは、暗号化するテキストを含む pbData メンバーのバイト文字列の長さを保持します。

[out, optional] ppszDataDescr

暗号化されたデータに含まれる暗号化されたデータの文字列を読み取り可能な説明へのポインター。 このパラメーターは NULL に設定できます。 ppszDataDescr の使用が完了したら、LocalFree 関数を呼び出して解放します。

[in, optional] pOptionalEntropy

データが暗号化されたときに使用されるパスワードまたはその他の追加エントロピを含む DATA_BLOB 構造体へのポインター。 このパラメーターは NULL に設定できます。ただし、暗号化フェーズで省略可能なエントロピ DATA_BLOB 構造体を使用した場合は、その同じ DATA_BLOB 構造を復号化フェーズに使用する必要があります。 パスワードの保護については、「パスワードの 処理」を参照してください。

pvReserved

このパラメーターは将来使用するために予約されており、 NULL に設定する必要があります。

[in, optional] pPromptStruct

プロンプトを表示する場所とタイミング、およびプロンプトの内容に関する情報を提供するCRYPTPROTECT_PROMPTSTRUCT構造体へのポインター。 このパラメーターは NULL に設定できます。

[in] dwFlags

この関数のオプションを指定する DWORD 値。 このパラメーターには 0 を指定できます。この場合、オプションが設定されていないか、次のフラグを指定します。

[out] pDataOut

関数が復号化されたデータを格納する DATA_BLOB 構造体へのポインター。 DATA_BLOB構造体の使用が完了したら、LocalFree 関数を呼び出して pbData メンバーを解放します。

戻り値

関数が成功した場合、関数は TRUE を返します。

関数が失敗すると、 FALSE が返されます。

注釈

CryptProtectData 関数は、データが暗号化されるときにセッション キーを作成します。 そのキーは再び派生し、データ BLOB の暗号化を解除するために使用されます。

暗号化されたデータに追加された メッセージ認証コード (MAC) ハッシュ は、暗号化されたデータが何らかの方法で変更されたかどうかを検出するために使用されます。 ただし、改ざんが検出されたときに返される特定のエラー コードは、破損の性質によって異なる場合があります。 この関数は、ERROR_INVALID_DATA、ERROR_INVALID_PARAMETERを返すか、場合によっては出力が破損して成功する可能性があります。 アプリケーションは、データの改ざんを検出するために特定のエラー コードに依存しないようにする必要があります。 堅牢な改ざん検出を行うには、アプリケーション レベルで追加の整合性チェックを実装することを検討してください。

DATA_BLOB構造体の使用が完了したら、LocalFree 関数を呼び出して pbData メンバーを解放します。 NULL ではない ppszDataDescr も LocalFree を使用して解放する必要があります。

機密情報の使用が完了したら、 SecureZeroMemory 関数を呼び出してメモリから消去します。

例示

次の例は、 DATA_BLOB 構造体で暗号化されたデータの暗号化を解除する方法を示しています。 この関数は、ユーザーのログオン資格情報を使用して関数が作成するセッション キーを使用して復号化を行います。 この関数を使用する別の例については、「 C Program の例: CryptProtectData の使用」を参照してください。

// Decrypt data from DATA_BLOB DataOut to DATA_BLOB DataVerify.

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

DATA_BLOB DataOut;
DATA_BLOB DataVerify;
LPWSTR pDescrOut =  NULL;
//--------------------------------------------------------------------
// The buffer DataOut would be created using the CryptProtectData
// function. If may have been read in from a file.

//--------------------------------------------------------------------
//   Begin unprotect phase.

if (CryptUnprotectData(
        &DataOut,
        &pDescrOut,
        NULL,                 // Optional entropy
        NULL,                 // Reserved
        NULL,                 // Here, the optional 
                              // prompt structure is not
                              // used.
        0,
        &DataVerify))
{
     printf("The decrypted data is: %s\n", DataVerify.pbData);
     printf("The description of the data was: %s\n",pDescrOut);
     LocalFree(DataVerify.pbData);
     LocalFree(pDescrOut);
}
else
{
    printf("Decryption error!");
}

Requirements

こちらも参照ください

CryptProtectData

CryptUnprotectMemory

データ暗号化および復号化関数

LocalFree

Microsoft Base Cryptographic Provider