SafeHandle.DangerousAddRef(Boolean) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
SafeHandle 인스턴스의 참조 카운터의 값을 수동으로 증가시킵니다.
public:
void DangerousAddRef(bool % success);
[System.Security.SecurityCritical]
public void DangerousAddRef (ref bool success);
public void DangerousAddRef (ref bool success);
[<System.Security.SecurityCritical>]
member this.DangerousAddRef : bool -> unit
member this.DangerousAddRef : bool -> unit
Public Sub DangerousAddRef (ByRef success As Boolean)
매개 변수
- success
- Boolean
참조 카운터 값이 성공적으로 증가하면true
이고, 그렇지 않으면 false
입니다.
- 특성
설명
이 메서드는 DangerousAddRef 공용 언어 런타임이 핸들에서 사용하는 메모리를 회수하지 못하도록 합니다(런타임이 메서드를 호출 ReleaseHandle 할 때 발생함). 이 메서드를 사용하여 인스턴스에 대한 SafeHandle 참조 수를 수동으로 증분할 수 있습니다. DangerousAddRef는 참조 수가 성공적으로 증가했는지 여부를 나타내는 매개 변수(success
)를 사용하여 ref
부울 값을 반환합니다. 이렇게 하면 오류 발생 시 프로그램 논리를 철회할 수 있습니다. 를 호출DangerousAddRef하기 false
전에 설정 success
해야 합니다. 이 경우 success
호출을 해당 호출 DangerousAddRef 과 일치시켜 리소스 누수가 발생하지 않도록 합니다DangerousRelease.true
주의
이 방법은 고급 사용자를 위한 것이며 항상 신중하게 사용해야 합니다. 핸들 리소스가 누출되지 않도록 하려면 스레드 중단이 처리를 중단할 수 없는 제한된 실행 영역(CER) 내에서 항상 이 메서드를 호출합니다.