Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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 |
|---|---|
|
O objeto especificado atendeu à espera. |
|
Ocorreu um tempo limite. |
|
A espera foi anulada para entregar um alerta ao thread atual. |
|
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 |