555448650331e04e366aae2e6a843d52c8db545b
[mirror_edk2.git] / CryptoPkg / Library / BaseCryptLibRuntimeCryptProtocol / Pk / CryptAuthenticodeNull.c
1 /** @file\r
2   Authenticode Portable Executable Signature Verification which does not provide\r
3   real capabilities.\r
4 \r
5 Copyright (c) 2012, Intel Corporation. All rights reserved.<BR>\r
6 This program and the accompanying materials\r
7 are licensed and made available under the terms and conditions of the BSD License\r
8 which accompanies this distribution.  The full text of the license may be found at\r
9 http://opensource.org/licenses/bsd-license.php\r
10 \r
11 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
12 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
13 \r
14 **/\r
15 \r
16 #include "InternalCryptLib.h"\r
17 \r
18 /**\r
19   Verifies the validility of a PE/COFF Authenticode Signature as described in "Windows\r
20   Authenticode Portable Executable Signature Format".\r
21 \r
22   Return FALSE to indicate this interface is not supported.\r
23 \r
24   @param[in]  AuthData     Pointer to the Authenticode Signature retrieved from signed\r
25                            PE/COFF image to be verified.\r
26   @param[in]  DataSize     Size of the Authenticode Signature in bytes.\r
27   @param[in]  TrustedCert  Pointer to a trusted/root certificate encoded in DER, which\r
28                            is used for certificate chain verification.\r
29   @param[in]  CertSize     Size of the trusted certificate in bytes.\r
30   @param[in]  ImageHash    Pointer to the original image file hash value. The procudure\r
31                            for calculating the image hash value is described in Authenticode\r
32                            specification.\r
33   @param[in]  HashSize     Size of Image hash value in bytes.\r
34 \r
35   @retval FALSE  This interface is not supported.\r
36 \r
37 **/\r
38 BOOLEAN\r
39 EFIAPI\r
40 AuthenticodeVerify (\r
41   IN  CONST UINT8  *AuthData,\r
42   IN  UINTN        DataSize,\r
43   IN  CONST UINT8  *TrustedCert,\r
44   IN  UINTN        CertSize,\r
45   IN  CONST UINT8  *ImageHash,\r
46   IN  UINTN        HashSize\r
47   )\r
48 {\r
49   ASSERT (FALSE);\r
50   return FALSE;\r
51 }\r