The Win32::NetResource module allows you to manage shared resources
on a network, such as printers, disks, etc. Two data structures
are used to provide or store information for many of the NetResource
functions. The first is the
share_info hash. This hash contains
parameters for setting up a share, using the following structure:
A%share_info = ( netname => "name of share", type => "type of share", remark => "a string comment", permissions => "permissions value", maxusers => "the max number of users", current-users => "the current number of users", path => "the path of the share", passwd => "password, if required" );
netresourcedata structure contains information about the shared resource or device. It has the following structure:
The first three elements of the%netresource = ( 'Scope' => "Scope of a resource connection (see table below for values)", 'Type' => "The type of resource (see table below)", 'DisplayType' => "How the resource should be displayed (see table below)", 'Usage' => "How the resource should be used", 'LocalName' => "Name of the local device the resource is connected to", 'RemoteName' => "Network name of the resource", 'Comment' => "Comment string", 'Provider' => "Provider of the resource" );
netresourcehash contain values described in the following tables. The
Scopevalue can be one of the following:
TheRESOURCE_CONNECTED Resource is already connected. RESOURCE_REMEMBERED Resource is reconnected each time the user logs on. RESOURCE_GLOBALNET Resource is available to the entire network.
Typeelement takes one of the following values:
TheRESOURCETYPE_ANY All resources RESOURCETYPE_DISK Disk resources RESOURCETYPE_PRINT Print resources
Displayelement can be one of these values:
The functions in Win32::NetResource use theRESOURCEDISPLAYTYPE_DOMAIN The object is displayed as a domain. RESOURCEDISPLAYTYPE_SERVER The object is displayed as a server. RESOURCEDISPLAYTYPE_SHARE The object is displayed as a sharepoint. RESOURCEUSAGE_CONNECTABLE The resource can be connected to a local device. RESOURCEUSAGE_CONTAINER The resource contains more resources.
netresourcestructures as input and output arguments. These arguments are used in the description of the functions below; you should name them whatever you want.