NetShareAdd or Net32ShareAdd

The NetShareAdd API shares the resource of a server.

Restrictions

This API can be called from DLS and OS/2 workstations. DLS workstations can issue this call locally only if the Peer service is started. A call to this API must be issued to a server or to a workstation with the Peer service installed. Administrator authority is required to call this API.

#include <netcons.h>
#include <shares.h>
#include <access.h>
 
NetShareAdd(pszServername, sLevel,
            buf, usBuflen);    /* 16 bit */
 
Net32ShareAdd(pszServername, ulLevel,
            buf, ulBuflen);    /* 32 bit */

See Common Parameter Definitions for descriptions of parameters not defined here.

sLevel or ulLevel

Share Level 2

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ┌─────────────────────────────┬───────┬────────────────────────────────────────┐│SYMBOLICCONSTANT │VALUE│MEANING │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_Success │ 0 │ No errors were encountered. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_ACCESS_DENIED │ 5 │ Administrator privilege is required. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_NOT_SUPPORTED │ 50 │ This request is not supported by the │
│ │ │ network. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_BAD_NETPATH │ 53 │ The network path cannot be found. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_NETWORK_ACCESS_DENIED │ 65 │ Network access is denied. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_PARAMETER │ 87 │ At least one parameter value is not │
│ │ │ valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_NAME │ 123 │ There is an incorrect character or │
│ │ │ incorrectly formed file system name. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_LEVEL │ 124 │ The sLevel parameter is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_FILENAME_EXCED_RANGE │ 206. │ The file name is longer than 8 charac- │
│ │ │ ters or the extension is longer than 3 │
│ │ │ characters. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NetNotStarted │ 2102 │ The redirector NETWKSTA.200 has not │
│ │ │ been started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_UnknownServer │ 2103 │ The server cannot be located. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_ServerNotStarted │ 2114 │ The Server service has not been │
│ │ │ started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_UnknownDevDir │ 2116 │ The device or directory does not │
│ │ │ exist. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_RedirectedPath │ 2117 │ The operation is not valid on a redi- │
│ │ │ rected device. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DuplicateShare │ 2118 │ The name has already been shared. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_NoRoom │ 2119 │ The server is currently out of the │
│ │ │ requested resource. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BufTooSmall │ 2123 │ The buffer is too small for fixed- │
│ │ │ length data. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_WkstaNotStarted │ 2138 │ The Requester service has not been │
│ │ │ started. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BadTransactConfig │ 2141 │ The server is not configured for │
│ │ │ transactions. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_QNotFound │ 2150 │ The printer queue does not exist. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_DeviceShareConflict │ 2318 │ This device cannot be shared as both a │
│ │ │ spooled and a non-spooled device. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BadDevString │ 2340 │ This list of devices is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BadDev │ 2341 │ The requested device is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InvalidComputer │2351 │Thespecifiedcomputernameisnot │
│ │ │ valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_CantType │ 2357 │ The type of input cannot be deter- │
│ │ │ mined. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘

Other codes could be returned from the following functions:

DosDevIOCtl
DosFsRamSemRequest
DosFsCtl
DosGetProcAddr
DosGetShrSeg
DosLoadModule
DosPrintDestGetInfo
DosSemRequest

Depending on the type of share specified by the value in the shi2_type component of the share_info_2 data structure, other components in the data structure must be specified as follows: ┌────────────────────┬───────┬─────────────────────────────────────────────────┐│SYMBOLICCONSTANT │VALUE│COMPONENTREQUIREMENTS │
├────────────────────┼───────┼─────────────────────────────────────────────────┤
│ STYPE_DISKTREE │ 0 │ shi2_path must specify a file-system path name. │
├────────────────────┼───────┼─────────────────────────────────────────────────┤
│ STYPE_PRINTQ │ 1 │ shi2_path must specify the name of an existing │
│ │ │ spooler queue. It is recommended that the │
│ │ │ netname and the path be the same; otherwise, │
│ │ │ the results are unpredictable. │
├────────────────────┼───────┼─────────────────────────────────────────────────┤
│ STYPE_DEVICE │ 2 │ shi2_path must either be passed as a null │
│ │ │ pointer or point to a list of print destina- │
│ │ │ tions, separated by spaces. The list must be │
│ │ │ the same as those specified for the spooler │
│ │ │ queue. │
├────────────────────┼───────┼─────────────────────────────────────────────────┤
│ STYPE_IPC │ 3 │ shi2_netname must specify a shared interprocess │
│ │ │ communication resource, and shi2_path must │
│ │ │ point to a null string. │
└────────────────────┴───────┴─────────────────────────────────────────────────┘

NetShareAdd ignores the value specified in the shi2_current_uses component of share_info_2.

For information about:

Removing a list of shareable resources, see Share - NetShareDel.
Listing the shareable resources of a server, see Share - NetShareEnum.

[Back: Related Information]

[Next: NetShareCheck or Net32ShareCheck]