Compartir vía

IHostSyncManager::CreateSemaphore (Método)

Crea un objeto IHostSemaphore a fin de que Common Language Runtime (CLR) lo use como semáforo para eventos de espera.

Sintaxis

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

Parámetros

dwInitial
[in] Recuento inicial de ppSemaphore.

dwMax
[in] Recuento máximo de ppSemaphore.

ppSemaphore
[out] Puntero a la dirección de una instancia de IHostSemaphore o null si no se ha podido crear el semáforo.

Valor devuelto

HRESULT Descripción
S_OK CreateSemaphore se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Si se devuelve este valor, significa que no hubo suficiente memoria disponible para crear el objeto de evento que se solicitó.

Comentarios

CreateSemaphore refleja la función de Win32 que tiene el mismo nombre. Los parámetros dwInitial y dwMax usan la misma semántica para el recuento de semáforos que los parámetros lInitialCount y lMaximumCount de Win32, respectivamente. dwInitial debe estar comprendido entre cero y dwMax, incluidos. dwMax debe ser mayor que cero.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también

  • Last updated on