Marcar booliano argumentos P/Invoke com MarshalAs

TypeName	MarkBooleanPInvokeArgumentsWithMarshalAs
CheckId	CA1414
Category (Categoria)	Microsoft.interoperabilidade
Quebrando alterar	Quebrando

Causa

Uma plataforma de invocar o método declaração inclui um System.Boolean parâmetro ou valor retornado, mas o System.Runtime.InteropServices.MarshalAsAttribute atributo não é aplicado ao parâmetro ou valor retornado.

Descrição da regra

Uma invocação de plataforma código não gerenciado do método acessos e é definida usando o Declare palavra-chave no Visual Basic ou o System.Runtime.InteropServices.DllImportAttribute. MarshalAsAttribute Especifica o comportamento de marshaling usado para converter tipos de dados entre código gerenciado e. Vários tipos de dados simples, sistema autônomo System.Byte e System.Int32, têm uma única representação em código não gerenciado e não não necessário seu comportamento de marshaling especificado; o common linguagem tempo de execução fornece automaticamente o comportamento correto.

The Boolean o tipo de dados possui várias representações em código não gerenciado. Quando o MarshalAsAttribute não for especificado, o padrão de marshaling de comportamento para o Boolean tipo de dados UnmanagedType.Bool. Isso é um inteiro de 32 bit, que não é adequado em todas as circunstâncias.A representação booliano exigida pelo método não-gerenciado deve ser determinada e coincidem com o apropriado System.Runtime.InteropServices.UnmanagedType. UnmanagedType.Bool é o tipo de Win32 BOOL, que é sempre 4 bytes.UnmanagedType.U1 deve ser usado para C++ bool ou outros tipos de 1 byte. Para obter mais informações, consulte Padrão de marshaling para tipos booleanos.

Como corrigir violações

Para corrigir uma violação dessa regra, aplicar MarshalAsAttribute para o Boolean valor de parâmetro ou retorno. Defina o valor do atributo para o apropriado UnmanagedType.

Quando suprimir avisos

Não suprimir um aviso da regra.Mesmo que o padrão de marshaling comportamento apropriado, o código mais fácil é mantido quando o comportamento especificado explicitamente.

Exemplo

O exemplo a seguir mostra a invocação de plataforma dois métodos marcados com o apropriado MarshalAsAttribute atributos.

Imports System
Imports System.Runtime.InteropServices

<assembly: ComVisible(False)>
Namespace UsageLibrary

   <ComVisible(True)> _
   Class NativeMethods

      Private Sub New()
      End Sub

      <DllImport("user32.dll", SetLastError := True)> _
      Friend Shared Function MessageBeep(uType As UInt32) _
         As <MarshalAs(UnmanagedType.Bool)> Boolean
      End Function

      <DllImport("mscoree.dll", SetLastError := True)> _
      Friend Shared Function StrongNameSignatureVerificationEx( _
         <MarshalAs(UnmanagedType.LPWStr)> wszFilePath As String, _
         <MarshalAs(UnmanagedType.U1)> fForceVerification As Boolean, _
         <MarshalAs(UnmanagedType.U1)> ByRef pfWasVerified As Boolean) _
         As <MarshalAs(UnmanagedType.U1)> Boolean
      End Function

   End Class

End Namespace

using System;
using System.Runtime.InteropServices;

[assembly: ComVisible(false)]
namespace InteroperabilityLibrary
{
   [ComVisible(true)]
   internal class NativeMethods
   {
      private NativeMethods() {}

      [DllImport("user32.dll", SetLastError = true)]
      [return: MarshalAs(UnmanagedType.Bool)]
      internal static extern Boolean MessageBeep(UInt32 uType);

      [DllImport("mscoree.dll", 
                 CharSet = CharSet.Unicode, 
                 SetLastError = true)]
      [return: MarshalAs(UnmanagedType.U1)]
      internal static extern bool StrongNameSignatureVerificationEx(
         [MarshalAs(UnmanagedType.LPWStr)] string wszFilePath,
         [MarshalAs(UnmanagedType.U1)] bool fForceVerification,
         [MarshalAs(UnmanagedType.U1)] out bool pfWasVerified);
   }
}

using namespace System;
using namespace System::Runtime::InteropServices;

[assembly: ComVisible(false)];
namespace InteroperabilityLibrary
{
   [ComVisible(true)]
   ref class NativeMethods
   {
   private:
      NativeMethods() {}

   internal:
      [DllImport("user32.dll", SetLastError = true)]
      [returnvalue: MarshalAs(UnmanagedType::Bool)]
      static Boolean MessageBeep(UInt32 uType);

      [DllImport("mscoree.dll", 
                 CharSet = CharSet::Unicode, 
                 SetLastError = true)]
      [returnvalue: MarshalAs(UnmanagedType::U1)]
      static bool StrongNameSignatureVerificationEx(
         [MarshalAs(UnmanagedType::LPWStr)] String^ wszFilePath,
         [MarshalAs(UnmanagedType::U1)] Boolean fForceVerification,
         [MarshalAs(UnmanagedType::U1)] Boolean^ pfWasVerified);
   };
}

Regras relacionadas

Declarações P/Invoke devem ser portátil

Especifique o marshaling para argumentos de seqüência de caracteres de P/Invoke

Consulte também

Conceitos

Padrão de marshaling para tipos booleanos

Referência

System.Runtime.InteropServices.UnmanagedType

Outros recursos

Interoperação com Código Não-Gerenciado