SafeHandle.DangerousGetHandle Метод

Определение

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

public:
 IntPtr DangerousGetHandle();
public IntPtr DangerousGetHandle ();
member this.DangerousGetHandle : unit -> nativeint
Public Function DangerousGetHandle () As 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.

Комментарии

Этот метод можно использовать для получения фактического значения 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.

Внимание!

Использование метода может привести к угрозам безопасности, так как, если маркер был помечен как недопустимый с помощью SetHandleAsInvalid, DangerousGetHandle по-прежнему возвращает исходное, потенциально устаревшее значение Handle. DangerousGetHandleUsing 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. Дополнительные сведения DangerousAddRef об использовании DangerousRelease месодсафелисм.вописанииDangerousGetHandle методов и.See the DangerousAddRef and the DangerousRelease methods for more information about using the DangerousGetHandle methodsafely.

Безопасность

SecurityPermission
разрешение на вызов неуправляемого кода.for permission to call unmanaged code. Действие по обеспечению безопасности: LinkDemand.Security action: LinkDemand. Связанное перечисление:UnmanagedCodeAssociated enumeration: UnmanagedCode

Применяется к