SafeHandle.DangerousGetHandle SafeHandle.DangerousGetHandle SafeHandle.DangerousGetHandle SafeHandle.DangerousGetHandle Method

Definition

Gibt den Wert des handle-Felds zurück.Returns the value of the handle field.

public:
 IntPtr DangerousGetHandle();
public IntPtr DangerousGetHandle ();
member this.DangerousGetHandle : unit -> nativeint
Public Function DangerousGetHandle () As IntPtr

Gibt zurück

Ein IntPtr, der den Wert des handle-Felds darstellt.An IntPtr representing the value of the handle field. Wenn das Handle mit SetHandleAsInvalid() als ungültig markiert ist, gibt diese Methode dennoch den ursprünglichen Handlewert zurück, bei dem es sich um einen veralteten Wert handeln kann.If the handle has been marked invalid with SetHandleAsInvalid(), this method still returns the original handle value, which can be a stale value.

Hinweise

Mit dieser Methode können Sie den tatsächlichen handle-Wert aus einer Instanz der SafeHandle abgeleiteten Klasse abrufen.You can use this method to retrieve the actual handle value from an instance of the SafeHandle derived class. Diese Methode wird aus Gründen der Abwärtskompatibilität benötigt, da viele Eigenschaften in IntPtr den .NET Framework die Handlertypen zurückgeben.This method is needed for backwards compatibility because many properties in the .NET Framework return IntPtr handle types. IntPtrHandle-Typen sind plattformspezifische Typen, die zur Darstellung eines Zeigers oder Handles verwendet werden.IntPtr handle types are platform-specific types used to represent a pointer or a handle.

Achtung

Die Verwendung DangerousGetHandle der-Methode kann Sicherheitsrisiken darstellen, denn wenn das Handle mit SetHandleAsInvalidals ungültig markiert wurde DangerousGetHandle , gibt immer noch den ursprünglichen, potenziell veralteten handle-Wert zurück.Using the DangerousGetHandle method can pose security risks because, if the handle has been marked as invalid with SetHandleAsInvalid, DangerousGetHandle still returns the original, potentially stale handle value. Das zurückgegebene Handle kann auch zu einem beliebigen Zeitpunkt wieder verwendet werden.The returned handle can also be recycled at any point. Dies bedeutet, dass das Handle möglicherweise plötzlich nicht mehr funktioniert.At best, this means the handle might suddenly stop working. Wenn das Handle oder die Ressource, die das Handle darstellt, nicht vertrauenswürdigem Code verfügbar gemacht wird, kann dies schlimmstenfalls zu einem wiederverwendbaren Sicherheitsangriff auf das wiederverwendete oder zurückgegebene Handle führen.At worst, if the handle or the resource that the handle represents is exposed to untrusted code, this can lead to a recycling security attack on the reused or returned handle. Beispielsweise kann ein nicht vertrauenswürdiger Aufrufer Daten für das soeben zurückgegebene Handle Abfragen und Informationen für eine völlig nicht verknüpfte Ressource empfangen.For example, an untrusted caller can query data on the handle just returned and receive information for an entirely unrelated resource. Weitere Informationen DangerousAddRef zur Verwendung DangerousRelease von methodsicheresfindenSieunterdenMethodenund.DangerousGetHandleSee the DangerousAddRef and the DangerousRelease methods for more information about using the DangerousGetHandle methodsafely.

Sicherheit

SecurityPermission
für die Berechtigung zum Abrufen von nicht verwaltetem Code.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für: