Share via

Função NtWaitForSingleObject (winternl.h)

  • Artigo

Preterido. Aguarda até que o objeto especificado atinja um estado de signaled. NtWaitForSingleObject é substituído por WaitForSingleObject.

Sintaxe

NTSTATUS NtWaitForSingleObject(
  [in] HANDLE         Handle,
  [in] BOOLEAN        Alertable,
  [in] PLARGE_INTEGER Timeout
);

Parâmetros

[in] Handle

O identificador para o objeto de espera.

[in] Alertable

Especifica se um alerta pode ser entregue quando o objeto está aguardando.

TRUE

O alerta pode ser entregue.

FALSE

O alerta não pode ser entregue.

[in] Timeout

Um ponteiro para um tempo absoluto ou relativo durante o qual a espera deve ocorrer. Pode ser nulo. Se um tempo limite for especificado e o objeto não tiver atingido um estado de signaled quando o tempo limite expirar, a espera será atendida automaticamente. Se um valor de tempo limite explícito de zero for especificado, nenhuma espera ocorrerá se a espera não puder ser atendida imediatamente.

Retornar valor

O status de conclusão da espera. Os vários valores NTSTATUS são definidos em NTSTATUS. H, que é distribuído com o DDK do Windows.

Código de retorno Descrição
STATUS_SUCCESS
 O objeto especificado atendeu à espera.
STATUS_TIMEOUT
 Ocorreu um tempo limite.
STATUS_ALERTED
 A espera foi anulada para entregar um alerta ao thread atual.
STATUS_USER_APC
 A espera foi anulada para entregar uma APC (Chamada de Procedimento Assíncrono) do usuário para o thread atual.

Comentários

Como não há biblioteca de importação para essa função, você deve usar GetProcAddress.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winternl.h
Biblioteca ntdll.lib
DLL ntdll.dll