다음을 통해 공유


SafeBuffer.AcquirePointer(Byte*) 메서드

정의

중요

이 API는 CLS 규격이 아닙니다.

SafeBuffer 개체에서 메모리 블록에 대한 포인터를 가져옵니다.

public:
 void AcquirePointer(System::Byte* % pointer);
[System.CLSCompliant(false)]
public void AcquirePointer (ref byte* pointer);
[<System.CLSCompliant(false)>]
member this.AcquirePointer : Byte* -> unit

매개 변수

pointer
Byte*

SafeBuffer 개체 내부에서 포인터를 받기 위해 참조에서 전달하는 바이트 포인터입니다. 이 메서드를 호출하기 전에 이 포인터를 null로 설정해야 합니다.

특성

예외

Initialize 메서드가 호출되지 않았습니다.

설명

AcquirePointer 가 반환되면 매개 변수null가 인지 확인하여 pointer 경계 검사를 수행해야 합니다. 이 아닌 null경우 CER(제한된 실행 영역)에서 메서드를 호출 SafeBuffer.ReleasePointer 해야 합니다.

AcquirePointer 는 메서드를 SafeHandle.DangerousAddRef 호출하고 포인터를 노출합니다.

다음 예제에서는 메서드를 사용하는 방법을 보여 줍니다 AcquirePointer .

byte* pointer = null;  
RuntimeHelpers.PrepareConstrainedRegions();  
try {  
    MySafeBuffer.AcquirePointer(ref pointer);  
    // Use pointer here, with your own bounds checking.  
    }  
finally {  
    if (pointer != null)  
        MySafeBuffer.ReleasePointer();  
    }  

(바이트에 대한 포인터)를 다른 형식(T*)에 대한 포인터로 캐스팅 pointer 하는 경우 포인터 맞춤 문제가 있을 수 있습니다.

이 포인터를 사용하여 검사하는 모든 경계에 대해 책임을 져야 합니다.

적용 대상