Treinamento
Roteiro de aprendizagem
Configurar a rede para clientes Windows - Training
Configurar a rede para clientes Windows MD-100
Não há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
As funções WNet retornam códigos de erro para compatibilidade com o Windows para Grupos de Trabalho. Cada função WNet também define o valor do código de erro retornado por GetLastError.
Quando uma das funções WNet retorna ERROR_EXTENDED_ERROR, um aplicativo pode chamar a função WNetGetLastError para recuperar informações adicionais sobre o erro. Essas informações geralmente são específicas para o provedor de rede.
O exemplo a seguir ilustra uma função de tratamento de erros definida pelo aplicativo (NetErrorHandler). A função usa três argumentos: um identificador de janela, o código de erro retornado por uma das funções WNet e o nome da função que produziu o erro. Se o código de erro for ERROR_EXTENDED_ERROR, NetErrorHandler chamará WNetGetLastError para obter informações de erro estendidas e imprimirá as informações. O exemplo chama a função MessageBox para processar mensagens.
#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "mpr.lib")
#pragma comment(lib, "user32.lib")
BOOL WINAPI NetErrorHandler(HWND hwnd,
DWORD dwErrorCode,
LPSTR lpszFunction)
{
DWORD dwWNetResult, dwLastError;
CHAR szError[256];
CHAR szCaption[256];
CHAR szDescription[256];
CHAR szProvider[256];
// The following code performs standard error-handling.
if (dwErrorCode != ERROR_EXTENDED_ERROR)
{
sprintf_s((LPSTR) szError, sizeof(szError), "%s failed; \nResult is %ld",
lpszFunction, dwErrorCode);
sprintf_s((LPSTR) szCaption, sizeof(szCaption), "%s error", lpszFunction);
MessageBox(hwnd, (LPSTR) szError, (LPSTR) szCaption, MB_OK);
return TRUE;
}
// The following code performs error-handling when the
// ERROR_EXTENDED_ERROR return value indicates that the
// WNetGetLastError function can retrieve additional information.
else
{
dwWNetResult = WNetGetLastError(&dwLastError, // error code
(LPSTR) szDescription, // buffer for error description
sizeof(szDescription), // size of error buffer
(LPSTR) szProvider, // buffer for provider name
sizeof(szProvider)); // size of name buffer
//
// Process errors.
//
if(dwWNetResult != NO_ERROR) {
sprintf_s((LPSTR) szError, sizeof(szError),
"WNetGetLastError failed; error %ld", dwWNetResult);
MessageBox(hwnd, (LPSTR) szError, "WNetGetLastError", MB_OK);
return FALSE;
}
//
// Otherwise, print the additional error information.
//
sprintf_s((LPSTR) szError, sizeof(szError),
"%s failed with code %ld;\n%s",
(LPSTR) szProvider, dwLastError, (LPSTR) szDescription);
sprintf_s((LPSTR) szCaption, sizeof(szCaption), "%s error", lpszFunction);
MessageBox(hwnd, (LPSTR) szError, (LPSTR) szCaption, MB_OK);
return TRUE;
}
}
Treinamento
Roteiro de aprendizagem
Configurar a rede para clientes Windows - Training
Configurar a rede para clientes Windows MD-100
Documentação
Determinando a localização de um compartilhamento - Win32 apps
O exemplo a seguir demonstra como chamar a função WNetGetUniversalName para determinar o local de um compartilhamento em uma unidade redirecionada.
Recuperando informações sobre um recurso de rede - Win32 apps
Para identificar o provedor de rede que possui um recurso, um aplicativo pode chamar a função WNetGetResourceInformation, conforme ilustrado no exemplo de código a seguir.
Atribuindo uma unidade a um compartilhamento - Win32 apps
O exemplo a seguir demonstra como conectar uma letra de unidade a um compartilhamento de servidor remoto com uma chamada para a função WNetAddConnection2. O exemplo informa ao usuário se a chamada foi ou não bem-sucedida.