Compartir a través de

Función NtWaitForSingleObject (winternl.h)

  • Artículo

Desusado. Espera hasta que el objeto especificado alcanza un estado de signaled. NtWaitForSingleObject se sustituye por WaitForSingleObject.

Sintaxis

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

Parámetros

[in] Handle

Identificador del objeto wait.

[in] Alertable

Especifica si se puede entregar una alerta cuando el objeto está esperando.

TRUE

La alerta se puede entregar.

FALSE

No se puede entregar la alerta.

[in] Timeout

Puntero a un tiempo absoluto o relativo con el que se va a producir la espera. Puede ser NULL. Si se especifica un tiempo de espera y el objeto no ha alcanzado un estado de cuándo expira el tiempo de signaled espera, la espera se satisface automáticamente. Si se especifica un valor de tiempo de espera explícito de cero, no se produce ninguna espera si no se puede satisfacer inmediatamente la espera.

Valor devuelto

Estado de finalización de espera. Los distintos valores NTSTATUS se definen en NTSTATUS. H, que se distribuye con el DDK de Windows.

Código devuelto Descripción
STATUS_SUCCESS
 El objeto especificado cumplió la espera.
STATUS_TIMEOUT
 Se ha producido un tiempo de espera.
STATUS_ALERTED
 Se anuló la espera para entregar una alerta al subproceso actual.
STATUS_USER_APC
 La espera se anuló para entregar un usuario llamada a procedimiento asincrónico (APC) al subproceso actual.

Comentarios

Dado que no hay ninguna biblioteca de importación para esta función, debe usar GetProcAddress.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winternl.h
Library ntdll.lib
Archivo DLL ntdll.dll