IHostSyncManager::CreateSemaphore — Metoda
Tworzy obiekt IHostSemaphore środowiska uruchomieniowego języka wspólnego (CLR) do użycia jako semafor dla zdarzeń oczekiwania.
Składnia
HRESULT CreateSemaphore (
[in] DWORD dwInitial,
[in] DWORD dwMax,
[out] IHostSemaphore **ppSemaphore
);
Parametry
dwInitial
[in] Początkowa liczba dla .ppSemaphore
dwMax
[in] Maksymalna liczba dla .ppSemaphore
ppSemaphore
[out] Wskaźnik do adresu IHostSemaphore wystąpienia lub wartość null, jeśli nie można utworzyć semafora.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | CreateSemaphore zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Za mało pamięci, aby utworzyć żądany obiekt zdarzenia. |
Uwagi
CreateSemaphore dubluje funkcję Win32 o tej samej nazwie. Parametry dwInitial i dwMax używają tej samej semantyki dla semafora liczby odpowiednio win32 lInitialCount i lMaximumCount parametrów. dwInitial musi zawierać się między 0 a dwMax, włącznie. dwMax wartość musi być większa niż zero.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
