ICLRSyncManager::CreateRWLockOwnerIterator 메서드

2011-08-09

호스트에서 판독기 및 작성기 잠금을 기다리는 작업 집합을 파악하는 데 사용할 반복기를 만들도록 CLR(공용 언어 런타임)에 요청합니다.

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

매개 변수

cookie
[in] 원하는 판독기 및 작성기 잠금에 연결된 쿠키입니다.
pIterator
[out] GetRWLockOwnerNext 및 DeleteRWLockOwnerIterator 메서드로 전달될 수 있는 반복기에 대한 포인터입니다.

반환 값

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

설명

호스트는 대개 교착 상태 감지 중 CreateRWLockOwnerIterator, DeleteRWLockOwnerIterator 및 GetRWLockOwnerNext 메서드를 호출합니다. CLR(공용 언어 런타임)에서는 판독기 및 작성기 잠금을 활성 상태로 유지하려고 하지 않으므로 호스트에서 판독기 및 작성기 잠금을 유효하도록 만들어야 합니다. 호스트에서 잠금을 유효하도록 만들려면 다음과 같은 몇 가지 전략을 사용합니다.

호스트에서 IHostSemaphore::ReleaseSemaphore와 같은 판독기 및 작성기 잠금에 대한 릴리스 호출을 차단할 수 있습니다. 이때 이러한 차단으로 인해 교착 상태가 발생해서는 안됩니다.
호스트에서 판독기 및 작성기 잠금에 연결된 이벤트 개체에 대한 대기 종료를 중단하면서, 마찬가지로 이러한 중단으로 인해 교착 상태가 발생하지 않도록 할 수 있습니다.