Método de IHostSyncManager::CreateRWLockReaderEvent

Artigo
08/08/2011

Cria um objeto de evento de redefinição manual para a implementação de um bloqueio de leitor.

HRESULT CreateRWLockReaderEvent (
    [in]  BOOL bInitialState,
    [in]  SIZE_T cookie,
    [out] IHostManualEvent **ppEvent
);

Parâmetros

bInitialState
[in] true, se ppEvent deve ser sinalizado; Caso contrário, false.
cookie
[in] Um cookie para associar o bloqueio de leitor.
ppEvent
[out] Um ponteiro para o endereço de um IHostManualEvent da instância ou nulo se o objeto de evento não pôde ser criado.

Valor de retorno

HRESULT	Descrição
S_OK	CreateRWLockReaderEventretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O common language runtime (CLR) não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória disponível suficiente para criar o objeto de evento solicitado.

Comentários

As chamadas CLR CreateRWLockReaderEvent para obter uma referência a um IHostManualEvent instância para usar em sua implementação de um bloqueio de leitor. O host pode usar o cookie para determinar quais tarefas estão aguardando o bloqueio de leitor consultando o ICLRSyncManager interface.