Compartilhar via


Recuperando o nome da conexão

Para recuperar o nome do recurso de rede associado a um dispositivo local, um aplicativo pode chamar a função WNetGetConnection , conforme mostrado no exemplo a seguir.

O exemplo a seguir chama um manipulador de erros definido pelo aplicativo para processar erros e a função TextOut para impressão.

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"); 
}

Para obter mais informações sobre como usar um manipulador de erros definido pelo aplicativo, consulte Recuperando erros de rede.