Propriedade LastDllError (Objeto Err)

Artigo
08/25/2010

Retorna um código de erro do sistema produzido por uma chamada à biblioteca de link dinâmico (DLL).Somente leitura.

ReadOnly Property LastDllError() As Integer

Comentários

A propriedade LastDllError se aplica somente a chamadas DLL feitas do código do Visual Basic.Qual tal chamada for feita, a função chamada normalmente retorna um código indicando sucesso ou falha, e a propriedade LastDllError é preenchida.Verifique a documentação para as funções da DLL para determinar os valores de retorno que indicam sucesso ou falha.Quando quer que o código de falha seja retornado, o aplicativo Visual Basic deve imediatamente verificar a propriedade LastDllError.Nenhuma exceção é elevada quando a propriedade LastDllError é configurada.

Observação:
O LastDllError propriedade é protegida por LinkDemand, que ajuda a impedir que ele sendo acessados a partir do código não confiável. Entretanto, LinkDemand requer apenas o chamador imediato para ter permissão UnmanagedCode.Se seu código pode ser chamado de código parcialmente confiável, expor o valor de LastDllError sem validação é um risco de segurança. As limitações importantes sobre como usar o LinkDemand membro, consulte Exigem vs. LinkDemand .Para obter mais informações sobre permissões, consulte SecurityPermission e Permissões de acesso a código .

O LastDllError propriedade é protegida por LinkDemand, que ajuda a impedir que ele sendo acessados a partir do código não confiável. Entretanto, LinkDemand requer apenas o chamador imediato para ter permissão UnmanagedCode.Se seu código pode ser chamado de código parcialmente confiável, expor o valor de LastDllError sem validação é um risco de segurança.

As limitações importantes sobre como usar o LinkDemand membro, consulte Exigem vs. LinkDemand .Para obter mais informações sobre permissões, consulte SecurityPermission e Permissões de acesso a código .

Exemplo

O exemplo a seguir mostra como você pode usar a propriedade LastDllError depois de você chamar uma função no Window API.The PrintWindowCoordinates procedimento leva um identificador para uma janela e chama o GetWindowRect função. GetWindowRect preenche a estrutura de dados RECT com os comprimentos dos lados do retângulo que compõem a janela. Se você passar uma maçaneta inválida, um erro ocorre, e o número do erro está disponível através da propriedade LastDllError.

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