Método IHostSyncManager::CreateSemaphore

Artigo
08/25/2010

Cria um IHostSemaphore objeto para o Common linguagem tempo de execução (CLR) para usar sistema autônomo um sinal de eventos de espera.

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

Parâmetros

dwInitial
[in] A contagem inicial de ppSemaphore.
dwMax
[in] A contagem máxima de ppSemaphore.
ppSemaphore
[out] Um ponteiro para o endereço de um IHostSemaphore instância ou nulo se o sinal não pôde ser criado.

Valor de retorno

HRESULT	Descrição
S_OK	CreateSemaphore retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não há memória insuficiente criar o objeto de evento solicitado.

Comentários

CreateSemaphore espelha a função do Win32 que tem o mesmo nome. The dwInitial e dwMax parâmetros de usam a mesma semântica para a contagem de sinal sistema autônomo Win32 lInitialCount e lMaximumCount parâmetros, respectivamente. dwInitial deve estar entre zero e dwMax, inclusive. dwMax deve ser maior que zero.