Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Win32Exception

 

Gera uma exceção para um código de erro Win32.

Namespace:   System.ComponentModel
Assembly:  System (em System.dll)

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.ComponentModel.Win32Exception
          System.Net.HttpListenerException
          System.Net.NetworkInformation.NetworkInformationException
          System.Net.Sockets.SocketException
          System.Net.WebSockets.WebSocketException

[SerializableAttribute]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class Win32Exception : ExternalException, ISerializable

NomeDescrição
System_CAPS_pubmethodWin32Exception()

Inicializa uma nova instância da classe Win32Exception com o último erro Win32 que ocorreu.

System_CAPS_pubmethodWin32Exception(Int32)

Inicializa uma nova instância da classe Win32Exception com o erro especificado.

System_CAPS_pubmethodWin32Exception(Int32, String)

Inicializa uma nova instância de Win32Exception classe com o erro especificado e a descrição detalhada.

System_CAPS_protmethodWin32Exception(SerializationInfo, StreamingContext)

Inicializa uma nova instância de Win32Exception classe com o contexto especificado e as informações de serialização.

System_CAPS_pubmethodWin32Exception(String)

Inicializa uma nova instância de Win32Exception classe com a descrição detalhada especificada.

System_CAPS_pubmethodWin32Exception(String, Exception)

Inicializa uma nova instância da classe Win32Exception com a descrição detalhada e a exceção especificadas.

NomeDescrição
System_CAPS_pubpropertyData

Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception.)

System_CAPS_pubpropertyErrorCode

Obtém o HRESULT do erro.(Herdado de ExternalException.)

System_CAPS_pubpropertyHelpLink

Obtém ou define um link para o arquivo de ajuda associado a esta exceção.(Herdado de Exception.)

System_CAPS_pubpropertyHResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.(Herdado de Exception.)

System_CAPS_pubpropertyInnerException

Obtém a instância Exception que causou a exceção atual.(Herdado de Exception.)

System_CAPS_pubpropertyMessage

Recebe uma mensagem que descreve a exceção atual.(Herdado de Exception.)

System_CAPS_pubpropertyNativeErrorCode

Obtém o código de erro Win32 associado a essa exceção.

System_CAPS_pubpropertySource

Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception.)

System_CAPS_pubpropertyStackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.(Herdado de Exception.)

System_CAPS_pubpropertyTargetSite

Obtém o método que gera a exceção atual.(Herdado de Exception.)

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetBaseException()

Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes.(Herdado de Exception.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Conjuntos de SerializationInfo objeto com o número de linha e de nome de arquivo no qual o Win32Exception ocorreu.(Substitui o Exception.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetType()

Obtém o tipo em tempo de execução da instância atual. (Herdado de Exception.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que contém o HRESULT do erro.(Herdado de ExternalException.)

NomeDescrição
System_CAPS_proteventSerializeObjectState

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.(Herdado de Exception.)

Win32 error codes are translated from their numeric representations into a system message when they are displayed. Use P:System.ComponentModel.Win32Exception.NativeErrorCode to access the numeric representation of the error code associated with this exception. For more information about the error codes, see "Win32 Error Codes" in the Platform SDK documentation at http://msdn.microsoft.comhttp://msdn.microsoft.com/.

The following code example shows how to catch a Win32 exception and interpret its content. The example attempts to start a nonexistent executable, which results in a Win32 exception. Upon catching the exception, the example fetches the respective error message, code, and origin of the exception.

   try {
System.Diagnostics.Process myProc = new System.Diagnostics.Process();
myProc.StartInfo.FileName = "c:\nonexist.exe";  //Attempting to start a non-existing executable
myProc.Start();    //Start the application and assign it to the process component.    
   }
	    catch(Win32Exception w) {
Console.WriteLine(w.Message);
Console.WriteLine(w.ErrorCode.ToString());
Console.WriteLine(w.NativeErrorCode.ToString());
Console.WriteLine(w.StackTrace);
Console.WriteLine(w.Source);
Exception e=w.GetBaseException();
Console.WriteLine(e.Message);
    }

Plataforma Universal do Windows
Disponível desde 10
.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: