IHostSyncManager::CreateSemaphore 메서드

2011-08-09

CLR(공용 언어 런타임)에서 대기 이벤트의 세마포로 사용할 IHostSemaphore 개체를 만듭니다.

HRESULT CreateSemaphore (
    [in]  DWORD dwInitial,
    [in]  DWORD dwMax,
    [out] IHostSemaphore **ppSemaphore
);

매개 변수

dwInitial
[in] ppSemaphore의 초기 카운트입니다.
dwMax
[in] ppSemaphore의 최대 카운트입니다.
ppSemaphore
[out] IHostSemaphore 인스턴스의 주소에 대한 포인터이거나, 세마포를 만들 수 없는 경우에는 null입니다.

반환 값

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

설명

CreateSemaphore는 같은 이름의 Win32 함수를 미러링합니다. dwInitial 및 dwMax 매개 변수는 각각 Win32 lInitialCount 및 lMaximumCount 매개 변수와 같은 의미의 세마포 카운트를 사용합니다. dwInitial은 0과 dwMax 사이여야 하고 두 값을 포함해야 합니다. dwMax는 0보다 커야 합니다.