ErrObject.LastDllError Propriedade

public:
 property int LastDllError { int get(); };

public int LastDllError { get; }

public int LastDllError { [System.Security.SecurityCritical] get; }

member this.LastDllError : int

[<get: System.Security.SecurityCritical>]
member this.LastDllError : int

Public ReadOnly Property LastDllError As Integer

Valor de Propriedade

Um código de erro do sistema produzido por uma chamada a uma biblioteca de ligação dinâmica (DLL).

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo seguinte mostra como pode usar a propriedade LastDllError depois de chamar uma função na API Windows. O PrintWindowCoordinates procedimento leva uma alavanca a uma janela e chama a GetWindowRect função. GetWindowRect preenche a estrutura de dados RECT com os comprimentos dos lados do retângulo que compõem a janela. Se passar um handle inválido, ocorre um erro e o número de erro está disponível através da LastDllError propriedade.

Declare Function GetWindowRect Lib "user32" (
    ByVal hwnd As Integer, ByRef lpRect As RECT) As Integer

Public Structure RECT
    Public Left As Integer
    Public Top As Integer
    Public Right As Integer
    Public Bottom As Integer
End Structure

Const ERROR_INVALID_WINDOW_HANDLE As Long = 1400
Const ERROR_INVALID_WINDOW_HANDLE_DESCR As String = 
    "Invalid window handle."

Private Sub PrintWindowCoordinates(ByVal hwnd As Integer)
' Prints left, right, top, and bottom positions
' of a window in pixels.

  Dim rectWindow As RECT

  ' Pass in window handle and empty the data structure.
  ' If function returns 0, an error occurred.
  If GetWindowRect(hwnd, rectWindow) = 0 Then
      ' Check LastDllError and display a dialog box if the error
      ' occurred because an invalid handle was passed.
      If Err.LastDllError = ERROR_INVALID_WINDOW_HANDLE Then
          MsgBox(ERROR_INVALID_WINDOW_HANDLE_DESCR, Title:="Error!")
      End If
  Else
      Debug.Print(rectWindow.Bottom)
      Debug.Print(rectWindow.Left)
      Debug.Print(rectWindow.Right)
      Debug.Print(rectWindow.Top)
  End If
End Sub

Observações

A propriedade LastDllError aplica-se apenas a chamadas DLL feitas a partir de Visual Basic código. Quando tal chamada é feita, a função chamada normalmente devolve um código indicando sucesso ou falha, e a LastDllError propriedade é preenchida. Consulte a documentação das funções da DLL para determinar os valores de retorno que indicam sucesso ou falha. Sempre que o código de falha for devolvido, a aplicação Visual Basic deve verificar imediatamente a propriedade LastDllError. Não há exceção quando a LastDllError propriedade é definida.

Ver também

• Err()
• ErrorToString()