SafeHandle.DangerousGetHandle Method

Definition

Возвращает значение поля handle.Returns the value of the handle field.

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

Returns

IntPtr

Указатель IntPtr, представляющий значение поля handle.An IntPtr representing the value of the handle field. Если дескриптор был помечен как недопустимый с помощью SetHandleAsInvalid(), этот метод, тем не менее, возвращает исходное значение дескриптора, которое может быть устаревшим.If the handle has been marked invalid with SetHandleAsInvalid(), this method still returns the original handle value, which can be a stale value.

Remarks

Этот метод можно использовать для получения фактического значения Handle из экземпляра производного класса SafeHandle.You can use this method to retrieve the actual handle value from an instance of the SafeHandle derived class. Этот метод необходим для обеспечения обратной совместимости, так как многие свойства в .NET Framework возвращают IntPtr типы обработчиков.This method is needed for backwards compatibility because many properties in the .NET Framework return IntPtr handle types. IntPtr типы обработчиков — это типы, зависящие от платформы, используемые для представления указателя или маркера.IntPtr handle types are platform-specific types used to represent a pointer or a handle.

Caution

Использование метода DangerousGetHandle может привести к угрозам безопасности, так как, если маркер был помечен как недопустимый с SetHandleAsInvalid, DangerousGetHandle по-прежнему возвращает исходное, потенциально устаревшее значение Handle.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. Возвращаемый обработчик также может быть очищен в любой момент.The returned handle can also be recycled at any point. В лучшем случае это означает, что обработка может внезапно прерывать работу.At best, this means the handle might suddenly stop working. В худшем случае, если обработчик или ресурс, представляемый этим маркером, предоставляется ненадежному коду, это может привести к атаке безопасности при повторном использовании или возвращенном обработчике.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. Например, недоверенный вызывающий объект может запрашивать данные только что возвращенного маркера и получить сведения для совершенно несвязанного ресурса.For example, an untrusted caller can query data on the handle just returned and receive information for an entirely unrelated resource. Дополнительные сведения об использовании DangerousGetHandle месодсафели см. в описании методов DangerousAddRef и DangerousRelease.See the DangerousAddRef and the DangerousRelease methods for more information about using the DangerousGetHandle methodsafely.

Applies to