WaitForNtmsNotification-Funktion (ntmsapi.h)

Artikel
02/29/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die WaitForNtmsNotification-Funktion wartet auf die nächste Objektänderungsbenachrichtigung.

Syntax

DWORD WaitForNtmsNotification(
  [in]  HANDLE                         hNotification,
  [out] LPNTMS_NOTIFICATIONINFORMATION lpNotificationInformation,
  [in]  DWORD                          dwTimeout
);

Parameter

[in] hNotification

Benachrichtigungshandle, das von der OpenNtmsNotification-Funktion zurückgegeben wird.

[out] lpNotificationInformation

Zeiger auf eine NTMS_NOTIFICATIONINFORMATION Struktur, die die Benachrichtigungsinformationen empfängt.

[in] dwTimeout

Maximale Anzahl von Millisekunden, die gewartet werden sollen. Wenn Sie den Wert INFINITE angeben, tritt für diese Funktion kein Timeout auf.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_DATABASE_FAILURE	Fehler bei der Datenbankabfrage oder -aktualisierung.
ERROR_INVALID_HANDLE	Der im hNotification-Parameter angegebene Wert ist NULL oder ungültig.
ERROR_NO_DATA	Fehler bei der Benachrichtigungspipe. Versuchen Sie erneut, die Benachrichtigung einzurichten.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_TIMEOUT	Das Timeoutereignis ist abgelaufen.
ERROR_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntmsapi.h
Bibliothek	Ntmsapi.lib
DLL	Ntmsapi.dll

Weitere Informationen

CloseNtmsNotification

Datenbankbenachrichtigungsfunktionen

NTMS_NOTIFICATIONINFORMATION

OpenNtmsNotification

Freigeben über