Menambahkan Koneksi Jaringan

Untuk membuat koneksi ke sumber daya jaringan yang dijelaskan oleh strukturNETRESOURCE, aplikasi dapat memanggilWNetAddConnection2 , WNetAddConnection3, atau fungsiWNetUseConnection. Contoh berikut menunjukkan penggunaan fungsi WNetAddConnection2.

Sampel kode memanggil fungsi WNetAddConnection2, mengharuskan agar sistem memperbarui profil pengguna menggunakan informasi ini, sehingga membuat koneksi yang persisten atau "tetap." Sampel memanggil penangan kesalahan yang didefinisikan oleh aplikasi untuk memproses kesalahan, dan fungsi TextOut untuk mencetak.

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-versi lebih awal dari Windows untuk Workgroups. Aplikasi baru harus memanggil fungsiWNetAddConnection2 atau fungsiWNetAddConnection3.

Untuk informasi selengkapnya tentang menggunakan penanganan kesalahan yang didefinisikan oleh aplikasi, lihat Mengambil Kesalahan Jaringan.