다음을 통해 공유


ICLRSyncManager::CreateRWLockOwnerIterator 메서드

CLR(공용 언어 런타임)은 호스트가 판독기-작성기 잠금에서 대기 중인 작업 집합을 결정하는 데 사용할 반복기를 만들 것을 요청합니다.

구문

HRESULT CreateRWLockOwnerIterator (  
    [in]  SIZE_T    cookie,  
    [out] SIZE_T   *pIterator  
);  

매개 변수

cookie
[in] 원하는 판독기-작성기 잠금과 연결된 쿠키입니다.

pIterator
[out] GetRWLockOwnerNextDeleteRWLockOwnerIterator 메서드에 전달할 수 있는 반복기에 대한 포인터입니다.

Return Value

HRESULT 설명
S_OK CreateRWLockOwnerIterator가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.
HOST_E_INVALIDOPERATION CreateRWLockOwnerIterator가 현재 관리 코드를 실행 중인 스레드에서 호출되었습니다.

설명

일반적으로 호스트는 교착 상태 탐지 중 CreateRWLockOwnerIterator, DeleteRWLockOwnerIteratorGetRWLockOwnerNext 메서드를 호출합니다. 호스트는 CLR이 판독기-작성기 잠금을 활성 상태로 유지하려고 시도하지 않으므로 판독기-작성기 잠금이 여전히 유효한지 확인해야 합니다. 호스트가 잠금의 유효성을 보장하기 위한 몇 가지 전략을 사용할 수 있습니다.

  • 호스트는 읽기 권한자-작성기 잠금(예: IHostSemaphore::ReleaseSemaphore)에 대한 릴리스 호출을 차단하면서 이 블록이 교착 상태를 일으키지 않도록 할 수 있습니다.

  • 호스트는 판독기-작성기 잠금과 연결된 이벤트 개체에서 종료 대기를 차단하여, 다시 이 블록이 교착 상태를 일으키지 않도록 할 수 있습니다.

참고

CreateRWLockOwnerIterator는 현재 관리되지 않는 코드를 실행하는 스레드에서만 호출되어야 합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목