| 术语 | netdfsremove |
| 释义 | NetDfsRemove 语法： C++ NET_API_STATUS NetDfsRemove( __in LPWSTR DfsEntryPath, __in_opt LPWSTR ServerName, __in_opt LPWSTR ShareName ); NetDfsRemove功能 删除分布式文件系统(DFS)链接或在一个DFS链接的DFS名称空间的特定链接的目标。当删除一个特定的链接的目标，本身的链接被删除，如果该链接的最后一个环节的目标被删除。 Windows Server 2003的：如果夫妻双方ServerName参数和ShareName参数是NULL，函数删除该链接。 参数 DfsEntryPath [in] 一个字符串指针，指定通用命名约定(UNC)的DFS链接的路径。 该字符串可以两种形式之一。第一种形式如下： \\ \\共享名\\ DfsName \\ link_path 共享名是根目标服务器承载独立的DFS命名空间的名称; DfsName是DFS名称空间的名称和link_path是DFS链接。 第二种形式是如下： \\ \\域名\\ DomDfsname \\ link_path 其中DomainName是域的承载基于域的DFS命名空间的名称; DomDfsname是DFS名称空间的名称和link_path是DFS链接。 此参数是必需的。 服务器名[中，可选] 一个字符串指针，指定链接目标服务器的名称。有关详细信息，请参阅下面的备注部分。设置此参数为NULL，如果所有的链接和链接目标已被撤销。 共享名[中，可选] 一个字符串指针，指定链接目标共享名称。设置此参数为NULL，如果所有的链接和链接目标已被撤销。 返回值 如果函数成功，返回值是NERR_Success。 如果函数失败，返回值是一个系统错误代码。对于一个错误代码的列表，请参见系统错误代码。 备注 调用者必须具有在DFS服务器的管理员特权。如需有关通话功能，需要管理员权限的信息，请运行特权。 当您调用NetDfsRemove删除链接的目标，您必须指定ServerName参数相同的目标服务器的名称，您创建时指定的链接。例如，如果您指定的目标服务器的DNS名称时，您添加的对象，链接，您必须指定相同的DNS名称当您删除该链接。您不能指定NetBIOS名称。 实例 下面的代码示例演示如何从一个DFS目标链接使用调用NetDfsRemove功能。 #define UNICODE #include #include #include #include #pragma comment(lib, "Netapi32.lib") void wmain(int argc, wchar_t *argv[]) { DWORD res; // // All parameters are required. // if (argc < 4) wprintf(L"Syntax: %s DfsEntryPath ServerName ShareName\\n", argv[0]); else { // // Call the NetDfsRemove function // to remove the DFS link. // res = NetDfsRemove(argv[1], argv[2], argv[3]); // // Display the result of the call. // if(res == 0) printf("Removed DFS link\\n"); else printf("Error: %u\\n", res); } return; } 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderLmDfs.h(包括LmDfs.h或Lm.h) LibraryNetapi32.lib DLLNetapi32.dll 参见 网络管理概述 网络管理功能 分布式文件系统(DFS)功能 NetDfsAdd NetDfsEnum NetDfsRemoveStdRoot NetDfsRemoveFtRoot 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年7月30日 ＝＝英文原文＝＝NetDfsRemove Function Removes a Distributed File System (DFS) link or a specific link target of a DFS link in a DFS namespace. When removing a specific link target, the link itself is removed if the last link target of the link is removed. Windows Server 2003: If both the ServerName parameter and the ShareName parameters are NULL, the function removes the link. Syntax C++ NET_API_STATUS NetDfsRemove( __in LPWSTR DfsEntryPath, __in_opt LPWSTR ServerName, __in_opt LPWSTR ShareName ); Parameters DfsEntryPath [in] Pointer to a string that specifies the Universal Naming Convention (UNC) path of the DFS link. The string can be in one of two forms. The first form is as follows: \\\\ShareName\\DfsName\\link_path where ShareName 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. This parameter is required. ServerName [in, optional] Pointer to a string that specifies the server name of the link target. For more information, see the following Remarks section. Set this parameter to NULL if the link and all link targets are to be removed. ShareName [in, optional] Pointer to a string that specifies the share name of the link target. Set this parameter to NULL if the link and all link targets are to be removed. 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 The caller must have Administrator privilege on the DFS server. For more information about calling functions that require administrator privileges, see Running with Special Privileges . When you call NetDfsRemove to remove a target from a link, you must specify the same target server name in the ServerName parameter that you specified when you created the link. For example, if you specified the target server's DNS name when you added the target to the link, you must specify the same DNS name when you remove the link. You cannot specify the NetBIOS name. Examples The following code sample demonstrates how to remove a target from a DFS link using a call to the NetDfsRemove function. #define UNICODE #include #include #include #include #pragma comment(lib, "Netapi32.lib") void wmain(int argc, wchar_t *argv[]) { DWORD res; // // All parameters are required. // if (argc < 4) wprintf(L"Syntax: %s DfsEntryPath ServerName ShareName\\n", argv[0]); else { // // Call the NetDfsRemove function // to remove the DFS link. // res = NetDfsRemove(argv[1], argv[2], argv[3]); // // Display the result of the call. // if(res == 0) printf("Removed DFS link\\n"); else printf("Error: %u\\n", res); } return; } 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 NetDfsAdd NetDfsEnum NetDfsRemoveStdRoot NetDfsRemoveFtRoot Send comments about this topic to Microsoft Build date: 7/30/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb524817(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。