home | O'Reilly's CD bookshelfs | FreeBSD | Linux | Cisco | Cisco Exam    

Book HomeJava and XSLTSearch this book

22.11. Win32::NetResource

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:

%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"
);

A netresource data structure contains information about the shared resource or device. It has the following structure:

%netresource = (
      'Scope'       => "Scope of a resource connection (see list below for 
                        values)",
      'Type'        => "The type of resource (see list below)",
      'DisplayType' => "How the resource should be displayed (see list
                        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"
);

The first three elements of the netresource hash contain values described in the following lists. The Scope value can be one of the following:

RESOURCE_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

The Type element takes one of the following values:

RESOURCETYPE_ANY
All resources

RESOURCETYPE_DISK
Disk resources

RESOURCETYPE_PRINT
Print resources

The Display element can be one of these values:

RESOURCEDISPLAYTYPE_DOMAIN
Object is displayed as a domain

RESOURCEDISPLAYTYPE_SERVER
Object is displayed as a server

RESOURCEDISPLAYTYPE_SHARE
Object is displayed as a sharepoint

RESOURCEUSAGE_CONNECTABLE
Resource can be connected to a local device

RESOURCEUSAGE_CONTAINER
Resource contains more resources

The functions in Win32::NetResource use the share_info and netresource structures as input and output arguments. These arguments are used in the description of the functions below; you should name them whatever you want.



Library Navigation Links

Copyright © 2002 O'Reilly & Associates. All rights reserved.











??????????????@Mail.ru