NetDfsSetClientInfo 函数 (lmdfs.h)

修改有关分布式文件系统的信息 (DFS) DFS 客户端维护的缓存中的根或链接。

语法

NET_API_STATUS NET_API_FUNCTION NetDfsSetClientInfo(
  [in]           LPWSTR DfsEntryPath,
  [in, optional] LPWSTR ServerName,
  [in, optional] LPWSTR ShareName,
  [in]           DWORD  Level,
  [in]           LPBYTE Buffer
);

parameters

[in] DfsEntryPath

指向指定通用命名约定 (UNC) DFS 根或链接路径的字符串的指针。

对于链接，字符串可以是两种形式之一。 第一种形式如下所示：

\\ ServerName\DfsName\link_path

其中 ，ServerName 是承载独立 DFS 命名空间的根目标服务器的名称; DfsName 是 DFS 命名空间的名称; 和 link_path 是 DFS 链接。

第二种形式如下：

\\ DomainName\DomDfsname\link_path

其中 ，DomainName 是托管基于域的 DFS 命名空间的域的名称; DomDfsname 是 DFS 命名空间的名称; 和 link_path 是 DFS 链接。

对于根，字符串可以是以下两种形式之一：

\\ ServerName\DfsName

或

\\ DomainName\DomDfsname

其中，名称的值与前面所述的值相同。

此参数是必需的。

[in, optional] ServerName

指向指定 DFS 链接目标服务器名称的字符串的指针。 此参数是可选的。 有关详细信息，请参见“备注”部分。

[in, optional] ShareName

指向指定 DFS 链接目标共享名称的字符串的指针。 此参数是可选的。 有关其他信息，请参阅以下“备注”部分。

[in] Level

指定请求的信息级别。 此参数的取值可为下列值之一：

101

设置本地 DFS 链接的存储状态。 Buffer 参数指向DFS_INFO_101结构。

102

设置本地 DFS 链接超时。 Buffer 参数指向 DFS_INFO_102 结构。 有关更多信息，请参见下面的“备注”部分。

[in] Buffer

指向包含要设置的信息的缓冲区的指针。 此信息的格式取决于 Level 参数的值。 有关详细信息，请参阅 网络管理功能缓冲区。

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值为系统错误代码。 有关错误代码的列表，请参阅 系统错误代码。

注解

调用方必须在 DFS 服务器上具有管理员权限。 有关调用需要管理员权限的函数的详细信息，请参阅 使用特殊特权运行。

将超时设置为零可能不会立即删除 DFS 链接的本地缓存副本，因为线程可能引用条目。

由于 DFS 链接上只有一个超时，因此对于级别 102， 将忽略 ServerName 和 ShareName 参数。

将忽略DFS_STORAGE_STATE_ONLINE位和DFS_STORAGE_STATE_OFFLINE位。 仅当没有文件对活动计算机打开时， DFS_STORAGE_STATE_ACTIVE 位才有效。

要求

另请参阅

DFS_INFO_101

DFS_INFO_102

分布式文件系统 (DFS) 函数

NetDfsGetClientInfo

网络管理功能

网络管理概述