| 术语 | netdfsgetclientinfo |
| 释义 | NetDfsGetClientInfo 语法： C++ NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo( __in LPWSTR DfsEntryPath, __in_opt LPWSTR ServerName, __in_opt LPWSTR ShareName, __in DWORD Level, __out LPBYTE *Buffer ); NetDfsGetClientInfo功能 检索有关分布式文件系统(DFS)根或由DFS客户端缓存保持联系。 参数 DfsEntryPath [in] 一个字符串指针，指定通用命名约定(UNC)的DFS根或链接的路径。 对于一个链接，该字符串可以两种形式之一。第一种形式如下： \\ \\服务器\\ DfsName \\ link_path 其中ServerName是根目标服务器承载独立的DFS命名空间的名称; DfsName是DFS名称空间的名称和link_path是DFS链接。 第二种形式是如下： \\ \\域名\\ DomDfsname \\ link_path 其中DomainName是域的承载基于域的DFS命名空间的名称; DomDfsname是DFS名称空间的名称和link_path是DFS链接。 对于一个根，该字符串可以两种形式之一： \\ \\服务器\\ DfsName 或 \\ \\域名\\ DomDfsname 那里的名称的值为前面所述相同。 此参数是必需的。 服务器名[中，可选] 指针指向一个字符串指定DFS根目标或链接目标服务器的名称。此参数是可选的。 共享名[中，可选] 一个字符串指针，指定相应的份额到DFS根目标或链接目标名称。此参数是可选的。 Level [in] 指定请求的信息化Level。此参数可以是下列值之一。 ValueMeaning 1Return DFS根目录或DFS链接的名称。缓冲区参数指向DFS_INFO_1结构。 2Return DFS根目录或DFS链接的名称，状态，以及DFS的一系列目标。缓冲区参数指向DFS_INFO_2结构。 3Return DFS根目录或DFS链接的名称，状态和目标信息。缓冲区参数指向DFS_INFO_3结构。 4Return DFS根目录或DFS链接的名称，状态，GUID，请超时，和目标信息。缓冲区参数指向DFS_INFO_4结构。 缓冲区[out] 指向一个缓冲区，接收所要求的资料地址。此缓冲区分配制度，必须使用NetApiBufferFree释放功能。有关更多信息，请参阅网络管理功能，缓冲器和网络管理功能缓冲区长度。 返回值 如果函数成功，返回值是NERR_Success。 如果函数失败，返回值是一个系统错误代码。对于一个错误代码的列表，请参见系统错误代码。 备注 没有特殊组成员都需要使用NetDfsGetClientInfo功能。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderLmDfs.h(包括LmDfs.h或Lm.h) LibraryNetapi32.lib DLLNetapi32.dll 参见 网络管理概述 网络管理功能 分布式文件系统(DFS)功能 DFS_INFO_1 DFS_INFO_2 DFS_INFO_3 DFS_INFO_4 NetDfsSetClientInfo 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝NetDfsGetClientInfo Function Retrieves information about a Distributed File System (DFS) root or link from the cache maintained by the DFS client. Syntax C++ NET_API_STATUS NET_API_FUNCTION NetDfsGetClientInfo( __in LPWSTR DfsEntryPath, __in_opt LPWSTR ServerName, __in_opt LPWSTR ShareName, __in DWORD Level, __out LPBYTE *Buffer ); Parameters DfsEntryPath [in] Pointer to a string that specifies the Universal Naming Convention (UNC) path of a DFS root or link. For a link, the string can be in one of two forms. The first form is as follows: \\\\ServerName\\DfsName\\link_path where ServerName is the name of the root target server that hosts the stand-alone DFS namespace; DfsName is the name of the DFS namespace; and link_path is a DFS link. The second form is as follows: \\\\DomainName\\DomDfsname\\link_path where DomainName is the name of the domain that hosts the domain-based DFS namespace; DomDfsname is the name of the DFS namespace; and link_path is a DFS link. For a root, the string can be in one of two forms: \\\\ServerName\\DfsName or \\\\DomainName\\DomDfsname where the values of the names are the same as those described previously. This parameter is required. ServerName [in, optional] Pointer to a string that specifies the name of the DFS root target or link target server. This parameter is optional. ShareName [in, optional] Pointer to a string that specifies the name of the share corresponding to the DFS root target or link target. This parameter is optional. Level [in] Specifies the information level of the request. This parameter can be one of the following values. ValueMeaning 1Return the DFS root or DFS link name. The Buffer parameter points to a DFS_INFO_1 structure. 2Return the DFS root or DFS link name, status, and the number of DFS targets. The Buffer parameter points to a DFS_INFO_2 structure. 3Return the DFS root or DFS link name, status, and target information. The Buffer parameter points to a DFS_INFO_3 structure. 4Return the DFS root or DFS link name, status, GUID, time-out, and target information. The Buffer parameter points to a DFS_INFO_4 structure. Buffer [out] Pointer to the address of a buffer that receives the requested information. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths . Return Value If the function succeeds, the return value is NERR_Success. If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes . Remarks No special group membership is required for using the NetDfsGetClientInfo function. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderLmDfs.h (include LmDfs.h or Lm.h) LibraryNetapi32.lib DLLNetapi32.dll See Also Network Management Overview Network Management Functions Distributed File System (DFS) Functions DFS_INFO_1 DFS_INFO_2 DFS_INFO_3 DFS_INFO_4 NetDfsSetClientInfo Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb524810(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。