添加网络连接

  • 项目

若要与 NETRESOURCE 结构描述的网络资源建立连接，应用程序可以调用 WNetAddConnection2、 WNetAddConnection3 或 WNetUseConnection 函数。 以下示例演示如何使用 WNetAddConnection2 函数。

该代码示例调用 WNetAddConnection2 函数，指定系统应使用信息更新用户配置文件，从而创建“已记住”或持久连接。 此示例调用应用程序定义的错误处理程序来处理错误，并调用用于打印的 TextOut 函数。

DWORD dwResult; 
NETRESOURCE nr; 
//
// Call the WNetAddConnection2 function to make the connection,
//   specifying a persistent connection.
//
dwResult = WNetAddConnection2(&nr, // NETRESOURCE from enumeration 
    (LPSTR) NULL,                  // no password 
    (LPSTR) NULL,                  // logged-in user 
    CONNECT_UPDATE_PROFILE);       // update profile with connect information 
 
// Process errors.
//  The local device is already connected to a network resource.
//
if (dwResult == ERROR_ALREADY_ASSIGNED) 
{ 
    printf("Already connected to specified resource.\n"); 
    return dwResult; 
} 
 
//  An entry for the local device already exists in the user profile.
//
else if (dwResult == ERROR_DEVICE_ALREADY_REMEMBERED) 
{ 
    printf("Attempted reassignment of remembered device.\n"); 
    return dwResult; 
} 
else if(dwResult != NO_ERROR) 
{ 
    //
    // Call an application-defined error handler.
    //
    printf("WNetAddConnection2 failed.\n"); 
    return dwResult; 
} 
 
//
// Otherwise, report a successful connection.
//
printf("Connected to the specified resource.\n");

支持 WNetAddConnection 函数，以便与早期版本的 Windows for Workgroups 兼容。 新应用程序应调用 WNetAddConnection2 函数或 WNetAddConnection3 函数。

有关使用应用程序定义的错误处理程序的详细信息，请参阅 检索网络错误。