IHostSyncManager Interface

Provides methods that allow the common language runtime (CLR) to create synchronization primitives by calling the host instead of using the Win32 synchronization functions.

interface IHostSyncManager : IUnknown {
    HRESULT CreateAutoEvent (
        [out] IHostAutoEvent **ppEvent
    );
    HRESULT CreateCrst(
        [out] IHostCrst** ppCrst
    );
    HRESULT CreateCrstWithSpinCount (
        [in] DWORD dwSpinCount,
        [out] IHostCrst** ppCrst
    );
    HRESULT CreateManualEvent (
        [in] BOOL bInitialState,
        [out] IHostManualEvent **ppEvent
    );
    HRESULT CreateMonitorEvent (
        [in] SIZE_T Cookie,
        [out] IHostAutoEvent **ppEvent
    );
    HRESULT CreateRWLockReaderEvent (
        [in] BOOL bInitialState,
        [in] SIZE_T Cookie,
        [out] IHostManualEvent **ppEvent
    );
    HRESULT CreateRWLockWriterEvent (
        [in] SIZE_T Cookie,
        [out] IHostAutoEvent **ppEvent
    );
    HRESULT CreateSemaphore (
        [in] DWORD dwInitial,
        [in] DWORD dwMax,
        [out] IHostSemaphore **ppSemaphore
    ); 
    HRESULT SetCLRSyncManager (
        [in] ICLRSyncManager *pManager
    );
};

Methods

Method	Description
IHostSyncManager::CreateAutoEvent Method	Creates an auto-reset event object.
IHostSyncManager::CreateCrst Method	Creates a critical section object for synchronization.
IHostSyncManager::CreateCrstWithSpinCount Method	Creates a critical section object with spin count for synchronization.
IHostSyncManager::CreateManualEvent Method	Creates a manual-reset event object.
IHostSyncManager::CreateMonitorEvent Method	Creates a monitored auto-reset event object.
IHostSyncManager::CreateRWLockReaderEvent Method	Creates a manual-reset event object for the implementation of a reader lock.
IHostSyncManager::CreateRWLockWriterEvent Method	Creates an auto-reset event object for the implementation of a writer lock.
IHostSyncManager::CreateSemaphore Method	Creates an IHostSemaphore object for the CLR to use as a semaphore for wait events.
IHostSyncManager::SetCLRSyncManager Method	Sets the ICLRSyncManager instance to associate with the current IHostSyncManager instance.

Remarks

The CLR discovers the host's implementation of IHostSyncManager by calling the IHostControl::GetHostManager method with an IID of IID_IHostSyncManager.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Version: 2.0

See Also

Concepts

ICLRSyncManager Interface

Hosting Interfaces