This documentation is archived and is not being maintained.

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
    );
};

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.

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

Platforms: See .NET Framework System Requirements.

Header: MSCorEE.idl

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Show: