netresource.html

来自「perl教程」· HTML 代码 · 共 331 行 · 第 1/2 页

HTML
331
字号
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../displayToc.js"></script>
<script language="JavaScript" src="../../tocParas.js"></script>
<script language="JavaScript" src="../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../scineplex.css">
<title>Win32::NetResource - manage network resources in perl</title>
<link rel="stylesheet" href="../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>

<body>

<script>writelinks('__top__',2);</script>
<h1><a>Win32::NetResource - manage network resources in perl</a></h1>
<p><a name="__index__"></a></p>

<!-- INDEX BEGIN -->

<ul>

	<li><a href="#name">NAME</a></li>
	<li><a href="#synopsis">SYNOPSIS</a></li>
	<li><a href="#description">DESCRIPTION</a></li>
	<li><a href="#data_types">DATA TYPES</a></li>
	<li><a href="#functions">FUNCTIONS</a></li>
	<ul>

		<li><a href="#note">NOTE</a></li>
		<li><a href="#note">NOTE</a></li>
	</ul>

	<li><a href="#example">EXAMPLE</a></li>
	<li><a href="#author">AUTHOR</a></li>
</ul>
<!-- INDEX END -->

<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Win32::NetResource - manage network resources in perl</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
    <span class="keyword">use</span> <span class="variable">Win32::NetResource</span><span class="operator">;</span>
</pre>
<pre>
    <span class="variable">$ShareInfo</span> <span class="operator">=</span> <span class="operator">{</span>
                    <span class="string">'path'</span> <span class="operator">=&gt;</span> <span class="string">"C:\\MyShareDir"</span><span class="operator">,</span>
                    <span class="string">'netname'</span> <span class="operator">=&gt;</span> <span class="string">"MyShare"</span><span class="operator">,</span>
                    <span class="string">'remark'</span> <span class="operator">=&gt;</span> <span class="string">"It is good to share"</span><span class="operator">,</span>
                    <span class="string">'passwd'</span> <span class="operator">=&gt;</span> <span class="string">""</span><span class="operator">,</span>
                    <span class="string">'current-users'</span> <span class="operator">=&gt;</span><span class="number">0</span><span class="operator">,</span>
                    <span class="string">'permissions'</span> <span class="operator">=&gt;</span> <span class="number">0</span><span class="operator">,</span>
                    <span class="string">'maxusers'</span> <span class="operator">=&gt;</span> <span class="operator">-</span><span class="number">1</span><span class="operator">,</span>
                    <span class="string">'type'</span>  <span class="operator">=&gt;</span> <span class="number">0</span><span class="operator">,</span>
                    <span class="operator">}</span><span class="operator">;</span>
    
    <span class="variable">Win32::NetResource::NetShareAdd</span><span class="operator">(</span> <span class="variable">$ShareInfo</span><span class="operator">,</span><span class="variable">$parm</span> <span class="operator">)</span>
        <span class="keyword">or</span> <span class="keyword">die</span> <span class="string">"unable to add share"</span><span class="operator">;</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This module offers control over the network resources of Win32.Disks,
printers etc can be shared over a network.</p>
<p>
</p>
<hr />
<h1><a name="data_types">DATA TYPES</a></h1>
<p>There are two main data types required to control network resources.
In Perl these are represented by hash types.</p>
<dl>
<dt><strong><a name="item__netresource">%NETRESOURCE</a></strong>

<dd>
<pre>
    KEY                    VALUE
    
    'Scope'         =&gt;  Scope of an Enumeration
                        RESOURCE_CONNECTED,
                        RESOURCE_GLOBALNET,
                        RESOURCE_REMEMBERED.
    
    'Type'          =&gt;  The type of resource to Enum
                        RESOURCETYPE_ANY    All resources
                        RESOURCETYPE_DISK    Disk resources
                        RESOURCETYPE_PRINT    Print resources
    
    'DisplayType'   =&gt;  The way the resource should be displayed.
                        RESOURCEDISPLAYTYPE_DOMAIN    
                        The object should be displayed as a domain.
                        RESOURCEDISPLAYTYPE_GENERIC    
                        The method used to display the object does not matter.
                        RESOURCEDISPLAYTYPE_SERVER    
                        The object should be displayed as a server.
                        RESOURCEDISPLAYTYPE_SHARE    
                        The object should be displayed as a sharepoint.
    
    'Usage'         =&gt;  Specifies the Resources usage:
                        RESOURCEUSAGE_CONNECTABLE
                        RESOURCEUSAGE_CONTAINER.
    
    'LocalName'     =&gt;  Name of the local device the resource is 
                        connected to.
    
    'RemoteName'    =&gt;  The network name of the resource.
    
    'Comment'       =&gt;  A string comment.
    
    'Provider'      =&gt;  Name of the provider of the resource.</pre>
</dd>
</dl>
<dl>
<dt><strong><a name="item__share_info">%SHARE_INFO</a></strong>

<dd>
<p>This hash represents the SHARE_INFO_502 struct.</p>
</dd>
<pre>
    KEY                    VALUE
    'netname'        =&gt;    Name of the share.
    'type'           =&gt;    type of share.
    'remark'         =&gt;    A string comment.
    'permissions'    =&gt;    Permissions value
    'maxusers'       =&gt;    the max # of users.
    'current-users'  =&gt;    the current # of users.
    'path'           =&gt;    The path of the share.
    'passwd'         =&gt;    A password if one is req'd</pre>
</dl>
<p>
</p>
<hr />
<h1><a name="functions">FUNCTIONS</a></h1>
<p>
</p>
<h2><a name="note">NOTE</a></h2>
<p>All of the functions return false if they fail.</p>
<dl>
<dt><strong><a name="item_getsharedresources">GetSharedResources(\@Resources,dwType,\%NetResource = NULL)</a></strong>

<dd>
<p>Creates a list in @Resources of %NETRESOURCE hash references.</p>
</dd>
<dd>
<p>The return value indicates whether there was an error in accessing
any of the shared resources.  All the shared resources that were
encountered (until the point of an error, if any) are pushed into
@Resources as references to %NETRESOURCE hashes.  See example
below.  The \%NetResource argument is optional.  If it is not supplied,
the root (that is, the topmost container) of the network is assumed,
and all network resources available from the toplevel container will
be enumerated.</p>
</dd>
</li>
<dt><strong><a name="item_addconnection"><code>AddConnection(\%NETRESOURCE,$Password,$UserName,$Connection)</code></a></strong>

<dd>

⌨️ 快捷键说明

复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?