Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
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.
 
Value                 Meaning
────────────────────────────────────────────────────────────────────────────
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 distinct
                      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.
 
 
                                      ♦