NtWaitForSingleObject-Funktion (winternl.h)

Artikel
03/04/2024

Veraltet. Wartet, bis das angegebene Objekt den Status erreicht signaled. NtWaitForSingleObject wird durch WaitForSingleObject ersetzt.

Syntax

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

Parameter

[in] Handle

Das Handle für das Wait-Objekt.

[in] Alertable

Gibt an, ob eine Warnung übermittelt werden kann, wenn das Objekt wartet.

true

Die Warnung kann übermittelt werden.

false

Die Warnung kann nicht übermittelt werden.

[in] Timeout

Ein Zeiger auf eine absolute oder relative Zeit, über die die Wartezeit erfolgen soll. Kann NULL sein. Wenn ein Timeout angegeben wird und das Objekt keinen Zustand erreicht hat, in dem signaled das Timeout abläuft, wird die Wartezeit automatisch erfüllt. Wenn ein expliziter Timeoutwert von 0 angegeben wird, tritt keine Wartezeit auf, wenn die Wartezeit nicht sofort erfüllt werden kann.

Rückgabewert

Die status für den Warteabschluss. Die verschiedenen NTSTATUS-Werte werden in NTSTATUS definiert. H, das mit dem Windows DDK verteilt wird.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Das angegebene Objekt hat die Wartezeit erfüllt.
STATUS_TIMEOUT	Ein Timeout ist aufgetreten.
STATUS_ALERTED	Die Wartezeit wurde abgebrochen, um eine Warnung an den aktuellen Thread zu übermitteln.
STATUS_USER_APC	Die Wartezeit wurde abgebrochen, um einen asynchronen Prozeduraufruf (APC) des Benutzers an den aktuellen Thread zu übermitteln.

Hinweise

Da für diese Funktion keine Importbibliothek vorhanden ist, müssen Sie GetProcAddress verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winternl.h
Bibliothek	ntdll.lib
DLL	ntdll.dll

Freigeben über