IntPtr.Zero Campo
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um campo somente leitura que representa um inteiro com sinal que foi inicializado como zero.
public: static initonly IntPtr Zero;
public static readonly IntPtr Zero;
staticval mutable Zero : nativeint
Public Shared ReadOnly Zero As IntPtr
nativeint
O valor desse campo não é equivalente a null
. Use esse campo para determinar com eficiência se uma instância de IntPtr foi definida como um valor diferente de zero.
Por exemplo, suponha que a variável, ip, seja uma instância de IntPtr. Você pode determinar se ele foi definido comparando-o com o valor retornado por um construtor, por exemplo: " if ip != new IntPtr(0)...
". No entanto, invocar um construtor para obter um ponteiro não inicializado é ineficiente. É melhor codificar " " if ip != IntPtr.Zero...
ou " if !IntPtr.Zero.Equals(ip)...
".
Ao chamar a API do Windows do código gerenciado, você pode passar IntPtr.Zero em vez de null
se espera-se que um argumento seja um ponteiro ou um null
. Por exemplo, a chamada a seguir para a função do Windows CreateFile
fornece IntPtr.Zero os valores de pSecurityAttributes
argumento e hTemplateFile
.
using Microsoft.Win32.SafeHandles;
using System;
using System.Runtime.InteropServices;
public class Example
{
private const uint GENERIC_READ = 0x80000000;
private const uint OPEN_EXISTING = 3;
private const uint FILE_ATTRIBUTE_NORMAL = 128;
private const uint FILE_FLAG_OVERLAPPED = 0x40000000;
[DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
private static extern Microsoft.Win32.SafeHandles.SafeFileHandle CreateFile(
string lpFileName, System.UInt32 dwDesiredAccess, System.UInt32 dwShareMode,
IntPtr pSecurityAttributes, System.UInt32 dwCreationDisposition,
System.UInt32 dwFlagsAndAttributes, IntPtr hTemplateFile);
public static void Main()
{
SafeFileHandle hnd = CreateFile("CallOfTheWild.txt", GENERIC_READ, 0,
IntPtr.Zero, OPEN_EXISTING,
FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED,
IntPtr.Zero);
if (hnd.IsInvalid) {
Exception ex = Marshal.GetExceptionForHR(Marshal.GetHRForLastWin32Error());
Console.WriteLine("Attempt to open file failed:");
Console.WriteLine(" {0}", ex.Message);
return;
}
else {
Console.WriteLine("File successfully opened.");
hnd.Close();
}
}
}
// If the file cannot be found, the example displays the following output:
// Attempt to open file failed:
// The system cannot find the file specified. (Exception from HRESULT: 0x80070002)
open Microsoft.Win32.SafeHandles
open System
open System.Runtime.InteropServices
let GENERIC_READ = 0x80000000u
let OPEN_EXISTING = 3u
let FILE_ATTRIBUTE_NORMAL = 128u
let FILE_FLAG_OVERLAPPED = 0x40000000u
[<DllImport("kernel32.dll", SetLastError = true, CharSet = CharSet.Unicode)>]
extern SafeFileHandle CreateFile(
string lpFileName, uint dwDesiredAccess, uint dwShareMode,
nativeint pSecurityAttributes, uint dwCreationDisposition,
uint dwFlagsAndAttributes, nativeint hTemplateFile)
let hnd =
CreateFile("CallOfTheWild.txt", GENERIC_READ, 0u,
IntPtr.Zero, OPEN_EXISTING,
FILE_ATTRIBUTE_NORMAL ||| FILE_FLAG_OVERLAPPED,
IntPtr.Zero)
if hnd.IsInvalid then
let ex = Marshal.GetExceptionForHR(Marshal.GetHRForLastWin32Error())
printfn $"Attempt to open file failed:\n {ex.Message}"
else
printfn "File successfully opened."
hnd.Close()
// If the file cannot be found, the example displays the following output:
// Attempt to open file failed:
// The system cannot find the file specified. (Exception from HRESULT: 0x80070002)
Imports Microsoft.Win32.SafeHandles
Imports System.Runtime.InteropServices
Module Example
Private Const GENERIC_READ As UInteger = 2147483648
Private Const OPEN_EXISTING As UInteger = 3
Private Const FILE_ATTRIBUTE_NORMAL As UInteger = 128
Private Const FILE_FLAG_OVERLAPPED As UInteger = &h40000000
Private Declare Auto Function CreateFile Lib "Kernel32" Alias "CreateFileW" (
lpFileName As String, dwDesiredAccess As UInt32,
dwShareMode As UInt32, pSecurityAttributes As IntPtr,
dwCreationDisposition As UInt32, dwFlagsAndAttributes As UInt32,
hTemplateFile As IntPtr) As SafeFileHandle
Public Sub Main()
Dim hnd As SafeFileHandle = CreateFile("CallOfTheWild.txt", GENERIC_READ, 0,
IntPtr.Zero, OPEN_EXISTING,
FILE_ATTRIBUTE_NORMAL Or FILE_FLAG_OVERLAPPED,
IntPtr.Zero)
If hnd.IsInvalid Then
Dim ex As Exception = Marshal.GetExceptionForHR(Marshal.GetHRForLastWin32Error())
Console.WriteLine("Attempt to open file failed:")
Console.WriteLine(" {0}", ex.Message)
Return
Else
Console.WriteLine("File successfully opened.")
hnd.Close()
End If
End Sub
End Module
' If the file cannot be found, the example displays the following output:
' Attempt to open file failed:
' The system cannot find the file specified. (Exception from HRESULT: 0x80070002)
Nota
Embora seja Zero equivalente a null
para funções da API do Windows com parâmetros ou valores retornados que podem ser ponteiros ou null
, Zero não é equivalente a null
. Passar null
para o IntPtr.Zero.Equals
método sempre retorna false
.
Você também pode testar um null
valor retornado de chamadas de função da API do Windows que retornam um ponteiro ou um null
comparando o valor retornado com IntPtr.Zero. Por exemplo, a chamada para a GetWindow
função no exemplo a seguir tenta recuperar o identificador de uma janela inexistente. Se ela fosse chamada de código não gerenciado, a função retornaria null
, mas quando for chamada do código gerenciado, retornará IntPtr.Zero.
using System;
using System.Runtime.InteropServices;
public class Example
{
private const int GW_OWNER = 4;
[DllImport("user32", CharSet=CharSet.Auto, SetLastError=true, ExactSpelling=true)]
public static extern IntPtr GetWindow(IntPtr hwnd, int wFlag);
public static void Main()
{
IntPtr hwnd = new IntPtr(3);
IntPtr hOwner = GetWindow(hwnd, GW_OWNER);
if (hOwner == IntPtr.Zero)
Console.WriteLine("Window not found.");
}
}
// The example displays the following output:
// Window not found.
open System
open System.Runtime.InteropServices
let GW_OWNER = 4
[<DllImport("user32", CharSet=CharSet.Auto, SetLastError=true, ExactSpelling=true)>]
extern IntPtr GetWindow(nativeint hwnd, int wFlag)
let hwnd = IntPtr 3
let hOwner = GetWindow(hwnd, GW_OWNER)
if hOwner = IntPtr.Zero then
printfn "Window not found."
// The example displays the following output:
// Window not found.
Module Example
Private Const GW_OWNER As Integer = 4
Private Declare Function GetWindow Lib "user32" (hWnd As IntPtr,
wFlag As Integer) As IntPtr
Public Sub Main()
Dim hwnd = new IntPtr(3)
Dim hOwner As IntPtr = GetWindow(hwnd, GW_OWNER)
If hOwner = IntPtr.Zero Then
Console.WriteLine("Window not found.")
End If
End Sub
End Module
' The example displays the following output:
' Window not found.
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: