添加网络连接
若要与 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 函数。
有关使用应用程序定义的错误处理程序的详细信息,请参阅 检索网络错误。