NAME
   CDSA_FileValidate - Validate a manifest file against its target file

 SYNOPSIS
   #include <cssm.h>

   int CDSA_FileValidate( char         *target_file,
                          CSSM_RETURN  *CDSA_Ret_Status );

 LIBRARY
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS

   target_file     (input)    The full filespec of the file to be validated.
   CDSA_Ret_Status (output)   A CDSA status code.  If non-zero, the status
                              may be decoded using the routine
                              Decode_CDSA_Error.

 DESCRIPTION
   This routine validates a target file using the associated manifest file.
   It is the callable equivalent of CDSA$VALIDATE.EXE.

 RETURN VALUE

   VMS_Success or VMS_Failure

 ERRORS

   Errors are described in the CDSA technical standard.  See CDSA.

     CSSM_OK
     CSSM_ERRCODE_SELF_CHECK_FAILED
     CSSMERR_SD_NO_TARGETFILE
     CSSMERR_SD_NO_MANIFESTFILE
     CSSM_ERRCODE_MEMORY_ERROR
     CSSMERR_SD_MANIFESTFILE_OPEN_FAILED
     CSSMERR_SD_MANIFESTFILE_READ_FAILED
     CSSMERR_SD_TARGETFILE_STRING_NOT_FOUND
     CSSMERR_SD_TARGETFILE_TERMINATOR_NOT_FOUND