OpenNtmsNotification-Funktion (ntmsapi.h)

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

Die OpenNtmsNotification-Funktion öffnet einen Kanal zum Empfangen von RSM-Objektänderungsbenachrichtigungen für Objekte des angegebenen Typs.

Syntax

HANDLE OpenNtmsNotification(
  [in] HANDLE hSession,
  [in] DWORD  dwType
);

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] dwType

RSM-Objekttyp für Benachrichtigungen. Eine Liste der Werte finden Sie unter NtmsObjectsTypes.

Rückgabewert

Die OpenNtmsNotification-Funktion gibt ein Benachrichtigungshandle zurück, das Sie an die Funktionen WaitForNtmsNotification oder CloseNtmsNotification übergeben.

Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten. Diese Funktion kann einen der folgenden Werte zurückgeben.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_USE_ACCESS für den Computer wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden. Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_DATABASE_FAILURE	Fehler bei der Datenbankabfrage oder -aktualisierung.
ERROR_INVALID_HANDLE	Der im hSession-Parameter angegebene Wert ist NULL oder ungültig.
ERROR_NOT_CONNECTED	Es kann keine Verbindung mit dem RSM-Dienst hergestellt werden.
ERROR_SUCCESS	Die Funktion war erfolgreich.
INVALID_HANDLE_VALUE	Fehler bei der Funktion.

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

WaitForNtmsNotification