Most network driver functions return zero if successful and unique nonzero values for various error conditions. The following is a list of the possible return values.
WN_ACCESS_DENIED |
Security violation. |
WN_ALREADY_CONNECTED |
Local device already connected to a remote resource. |
WN_ALREADY_LOCKED |
Queue specified is already locked; from LockQueue function. |
WN_BAD_HANDLE |
Not a valid file handle, or handle not to network print file opened by driver. |
WN_BAD_JOBID |
Invalid job ID. |
WN_BAD_LOCALNAME |
Invalid local device name. |
WN_BAD_NETNAME |
Network name is invalid. |
WN_BAD_PASSWORD |
Incorrect password specified. |
WN_BAD_POINTER |
Invalid pointer specified. |
WN_BAD_QUEUE |
Name given does not correspond to a network queue name or a redirected local device. |
WN_BAD_USER |
Invalid user name specified. |
WN_BAD_VALUE |
Invalid value specified. |
WN_CANCELLED |
Operation canceled at user's request. |
WN_CANT_SET_COPIES |
Warning: cannot set number of copies, printing just one. |
WN_CONNECTION_CLOSED |
Indicates that a permanently maintained connection is defined for the device, but that the device is not currently connected to any network resource. This return value is defined for those network drivers that export the WNetRestoreConnection function. The only way a permanent connection can be closed is if the device could not be connected when starting up. |
WN_CONTINUE |
Used by functions to indicate a situation dis-tinct from both WN_CANCELLED and WN_SUCCESS where File Manager does not need to post a message to the user. |
WN_DEVICE_ERROR |
Specifies that a connection exists on the given device, but that the connection is in an error state and should be disconnected and reconnected before it is accessed again. Generally, File Manager will attempt to reconnect such devices by calling the WNetRestoreConnection function. |
WN_FUNCTION_BUSY |
Function can't be reentered and is currently being used. |
WN_JOB_NOT_FOUND |
No job found with this ID. |
WN_JOB_NOT_HELD |
Job cannot be released because it is not currently held. |
WN_MORE_DATA |
Warning: buffer too small. |
WN_NET_ERROR |
Miscellaneous network error. |
WN_NO_ERROR |
No error status available. |
WN_NOT_CONNECTED |
Device is not redirected. |
WN_NOT_SUPPORTED |
Function not supported. |
WN_OPEN_FILES |
Connection couldn't be canceled, files are still open. |
WN_OUT_OF_MEMORY |
Out of memory. |
WN_SUCCESS |
Success. |