CryptoPkg/Library/BaseCryptLib/Pk/CryptAuthenticodeNull.c

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