Functions.ANetResources 方法 | |
-- todo --
将网络共享或打印机的名称放入数组,然后返回资源数量。
命名空间:
XSharp.VFP
程序集:
XSharp.VFP (在 XSharp.VFP.dll 中) 版本:2.22 GA
语法 FUNCTION ANetResources(
ArrayName,
cNetworkName,
nResourceType
) AS USUAL CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static __Usual ANetResources(
__Usual ArrayName = default,
__Usual cNetworkName = default,
__Usual nResourceType = default
)
查看代码参数
- ArrayName (Optional)
- 类型:__Usual
指定包含网络共享或打印机信息的数组的名称。
- cNetworkName (Optional)
- 类型:__Usual
指定要返回共享或打印机信息的网络或域的名称。
- nResourceType (Optional)
- 类型:__Usual
指定要返回信息的网络资源类型。
返回值
类型:
__Usual
数值
备注
如果指定的数组不存在,X# 会自动创建该数组。如果数组存在但不够大,无法容纳所有信息,
X# 会自动增加数组的大小以容纳信息。如果数组大于所需大小,X# 会截断数组。
如果数组存在且 ANetResources() 返回 0(因为未找到网络共享或打印机),数组保持不变。
如果数组不存在且 ANetResources() 返回 0,则不会创建数组。
网络名称应采用 "\\NetworkName" 格式。您不必连接到指定的网络,
指定网络也不会使您连接到该网络。
如果指定域名,ANetResources() 将返回该域的成员或资源数组。
如果 nResourceType 的值为 1,则返回网络上的共享名称。
如果 nResourceType 的值为 2,则返回网络上的打印机名称。值为 0 时返回任何资源的名称。
ANetResources() 返回找到的网络共享或打印机数量(与数组中的行数相同)。
如果指定类型的网络没有共享或打印机,或指定的网络不存在,ANetResources() 返回零。
在 Windows 2000 之前,共享名称限制为十二个字符长度。
如果在使用早于 Windows 2000 的操作系统的计算机上运行 ANetResources(),
ANetResources() 将不会返回运行 Windows 2000 或更高版本的计算机上共享名称超过十二个字符的任何共享。
有关更多详细信息,请参阅 WNetOpenEnum 和 WNetEnumResource Win32 API 函数。
参见