Contents Up << >>
Error reference
This section lists all error codes which can be returned by Winseed routines and describes
the possible reasons for these errors.
- PCP_SUCCESS No errors were encountered.
- PCP_NULL_POINTER If a function returns this error code this means that one
of its paramters was NULL, even though this parameter was expected to be non NULL.
- PCP_SEEDER_FAILED This failure indicates (most of the time) that
a Windows function called by Winseed failed and Winseed was therefore unable to
complete the polling operation.
- PCP_SEEDER_NO_MEM Winseed returns this error code if it was unable to construct an
object dynamically. In other words a call to operator new returned NULL.
- PCP_SEEDER_TOO_SMALL Winseed returns this error if the internal seed size is
too small. This means that the internal buffer used by Winseed was too small to
hold all the data it tried to gather. You can increase this internal buffer size
through WS_set_internal_seed_size. If you increased the internal buffer size
to a value which is big enough subsequent calls to WS_get_seed will succeed.
Unfortunately Winseed is unable to tell you what buffer size it really needs.
- PCP_DLL_LOAD_FAILED This error code is generated if Winseed could not load
either netapi32.dll (Windows NT) or kernel32.dll (Windows 95/98). The most likely
reasons are that the searched DLL is either not in the global path or is not on your system.
(At least with kernel32.dll this should be quite difficult!!)
- PCP_UNKNOWN_PLATFORM Each time Winseed creates a new slow seeder instance
it checks whether the system it is running on is either Windows 95/98 or Windows NT.
This is neccessary due to the differences in the slow poll implememtations for
the two platforms. The platform check is done via a Windows function. If this
function indicates that the Windows version is neither Windows 95/98 nor Windows NT
this error code is produced. This means for instance that the current version of
Winseed will not run under Win32s.
- PCP_ERROR_VERSION This error code is generated if Winseed is unable to determine
on what Win32 implementation (95/98/NT) it is running.
- PCP_DLL_FUNC This error code is returned if a function in a DLL (netapi32.dll under NT,
kernel32.dll under 95/98) could not be loaded dynamically.
- PCP_UNKNOWN_SEEDER_TYPE This error code will be produced by WS_create_instance
if the requested seeder type was neither WIN32_SLOW_SEEDER nor WIN32_FAST_SEEDER