Menambahkan Koneksi Jaringan
Untuk membuat koneksi ke sumber daya jaringan yang dijelaskan oleh struktur NETRESOURCE , aplikasi dapat memanggil WNetAddConnection2, WNetAddConnection3, atau fungsi WNetUseConnection . Contoh berikut menunjukkan penggunaan fungsi WNetAddConnection2 .
Sampel kode memanggil fungsi WNetAddConnection2 , menentukan bahwa sistem harus memperbarui profil pengguna dengan informasi, membuat koneksi "diingat" atau persisten. Sampel memanggil penangan kesalahan yang ditentukan aplikasi untuk memproses kesalahan, dan fungsi TextOut untuk pencetakan.
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");
Fungsi WNetAddConnection didukung untuk kompatibilitas dengan versi Windows sebelumnya untuk Grup Kerja. Aplikasi baru harus memanggil fungsi WNetAddConnection2 atau fungsi WNetAddConnection3 .
Untuk informasi selengkapnya tentang menggunakan penangan kesalahan yang ditentukan aplikasi, lihat Mengambil Kesalahan Jaringan.