pgppflerrors.c

PGP8.0源码 请认真阅读您的文件包然后写出其具体功能

/*____________________________________________________________________________
	Copyright (C) 2002 PGP Corporation
	All rights reserved.

	$Id: pgpPFLErrors.c,v 1.10 2002/09/14 01:06:10 ajivsov Exp $
____________________________________________________________________________*/
#include <stdio.h>
#include <string.h>

#include "pgpPFLErrors.h"
#include "pgpPFLPriv.h"
#include "pgpMem.h"


typedef struct PFLErrorEntry
{
	PGPError const		number;
	const char * const	string;
} PFLErrorEntry;

#define EN(number, string)		{ number, string }


static const PFLErrorEntry sErrors[] =
{
EN( kPGPError_NoErr,					"not an error"),
EN( kPGPError_BadParams,				"bad parameters"),
EN( kPGPError_OutOfMemory,				"out of memory"),
EN( kPGPError_BufferTooSmall,			"buffer too small"),

EN( kPGPError_FileNotFound,				"file not found"),
EN( kPGPError_CantOpenFile,				"can't open file"),
EN( kPGPError_FilePermissions,			"file permissions"),
EN( kPGPError_FileLocked,				"file locked"),
EN( kPGPError_IllegalFileOp,			"illegal file operation"),
EN( kPGPError_FileOpFailed,				"file operation error"),
EN( kPGPError_ReadFailed,				"read failed"),
EN( kPGPError_WriteFailed,				"write failed"),
EN( kPGPError_EOF,						"end of file"),

EN( kPGPError_UserAbort,				"user cancelled"),
EN( kPGPError_UnknownRequest,			"unrecognized request"),
EN( kPGPError_LazyProgrammer,			"unknown error"),
EN( kPGPError_ItemNotFound,				"item not found"),
EN( kPGPError_ItemAlreadyExists,		"item already exists"),
EN( kPGPError_AssertFailed,				"assert failed"),
EN( kPGPError_BadMemAddress,			"bad memory address"),
EN( kPGPError_UnknownError,				"unknown error"),

EN( kPGPError_PrefNotFound,				"preference not found"),
EN( kPGPError_EndOfIteration,			"end of iteration"),
EN( kPGPError_ImproperInitialization,	"improper initialization"),
EN( kPGPError_CorruptData,				"corrupt data"),
EN( kPGPError_FeatureNotAvailable,		"feature not available"),

EN( kPGPError_DiskFull,					"disk full"),
EN( kPGPError_DiskLocked,				"disk locked"),

EN( kPGPError_GraphicsOpFailed,			"graphics operations failed"),
EN( kPGPError_MemoryOpFailed,			"memory operation failed"),
EN( kPGPError_NetworkOpFailed,			"network operation failed"),
EN( kPGPError_SecurityOpFailed,			"system security operation failed"),
EN( kPGPError_StringOpFailed,			"string operation failed"),
EN( kPGPError_SyncObjOpFailed,			"wait operation failed"),
EN( kPGPError_ThreadOpFailed,			"thread operation failed"),
EN( kPGPError_VolumeOpFailed,			"volume operation failed"),

EN( kPGPError_NTDrvIopOpFailed, 
   "NT driver I/O request operation failed"), 
EN( kPGPError_NTDrvObjectOpFailed, 
   "NT driver kernel object operation failed"), 

EN( kPGPError_Win32COMOpFailed,			"Win32 COM operation failed"), 
EN( kPGPError_Win32CommCtrlOpFailed, 
   "Win32 common controls operation failed"), 
EN( kPGPError_Win32DllOpFailed,			"Win32 DLL operation failed"), 
EN( kPGPError_Win32RegistryOpFailed,	"Win32 registry operation failed"), 
EN( kPGPError_Win32ResourceOpFailed,	"Win32 resource operation failed"), 
EN( kPGPError_Win32WindowOpFailed,		"Win32 window operation failed"),
EN( kPGPError_NetLARefused,				"license Authorization Server refused authorization"),
EN( kPGPError_NetLAMismatch,			"mismatch in some of data in License Athorization request"),
EN( kPGPError_NetLATooManyRetrievals,	"too many attempts to retrieve License Authorization Number"),
EN( kPGPError_LNCorrupt,				"failed to import License Number"),
EN( kPGPError_LACorrupt,				"failed to import License Authorization Number")

};

#define kPFLErrors_NumErrorTableEntries		\
	( sizeof( sErrors ) / sizeof( sErrors[ 0 ] ) )

#undef EN


	
	PGPError 
PGPGetPFLErrorString(
	PGPError	theError,
	PGPSize		bufferSize,
	char *		theString )
{
	PGPUInt32		idx;
	char			temp[ 256 ];
	char const *	errStr	= NULL;
	PGPSize			len	= 0;
	PGPBoolean		bufferBigEnough	= FALSE;
	
	PGPValidateParam( bufferSize >= 1 );
	PGPValidatePtr( theString );

	*theString	= '\0';
	
	for( idx = 0; idx < kPFLErrors_NumErrorTableEntries; ++idx )
	{
		const PFLErrorEntry *	entry;
		
		entry	= &sErrors[ idx ];
		if ( entry->number == theError )
		{
			errStr	= entry->string;
			break;
		}
	}
	
	if ( IsNull( errStr ) )
	{
		/* Produce something for missing errors */
		sprintf( temp, "PFLError #%ld", (long)theError );
		errStr	= temp;
	}
	
	len	= strlen( errStr );
	bufferBigEnough	= ( len + 1 <= bufferSize );
	if ( bufferBigEnough )
	{
		strcpy( theString, errStr );
	}
	else
	{
		pgpCopyMemory( errStr, theString, bufferSize - 1 );
		theString[ bufferSize - 1 ]	= '\0';
	}
	
	return( bufferBigEnough	? kPGPError_NoErr : kPGPError_BufferTooSmall );
}



/*__Editor_settings____

	Local Variables:
	tab-width: 4
	End:
	vi: ts=4 sw=4
	vim: si
_____________________*/