Retrieving the Connection Name

To retrieve the name of the network resource associated with a local device, an application can call the WNetGetConnection function, as shown in the following sample.

The following sample calls an application-defined error handler to process errors, and the TextOut function for printing.

TCHAR szDeviceName[80]; 
DWORD dwResult, cchBuff = sizeof(szDeviceName); 
 
// Call the WNetGetConnection function.
//
dwResult = WNetGetConnection(_T("z:"), 
 szDeviceName, 
 &cchBuff); 
 
switch (dwResult) 
{ 
 //
 // Print the connection name or process errors.
 //
 case NO_ERROR: 
 printf("Connection name: %s\n", szDeviceName); 
 break; 
 //
 // The device is not a redirected device.
 //
 case ERROR_NOT_CONNECTED: 
 printf("Device z: not connected.\n"); 
 break;
 //
 // The device is not currently connected, but it is a persistent connection.
 //
 case ERROR_CONNECTION_UNAVAIL: 
 printf("Connection unavailable.\n"); 
 break;
 //
 // Handle the error.
 //
 default: 
 printf("WNetGetConnection failed.\n"); 
}

For more information about using an application-defined error handler, see Retrieving Network Errors.