AdsSyncAddDeviceNotificationReqEx

Innerhalb eines ADS-Servers (z.B. SPS) wird eine Notification (Bekanntmachung) definiert. Beim Eintreten bestimmter Ereignisse, wird eine Funktion (Callbackfunktion) im ADS-Client (C-Programm) aufgerufen.

LONG AdsSyncAddDeviceNotificationReqEx(
  LONG                     port,
  PAmsAddr                 pAddr,
  ULONG                    nIndexGroup,
  ULONG                    nIndexOffset,
  PAdsNotificationAttrib   pNoteAttrib,
  PAdsNotificationFuncEx   pNoteFunc,
  ULONG                    hUser,
  PULONG                   pNotification
);

Parameter

port

[in] Portnummer eines Ads-Ports, der zuvor mit AdsPortOpenEx oder AdsPortOpen geöffnet worden ist.

pAddr

[in] Struktur mit NetId und Portnummer vom ADS-Server.

nIndexGroup

[in] IndexGroup.

nIndexOffset

[in] IndexOffset.

pNoteAttrib

[in] Zeiger auf die Struktur, welche weitere Informationen enthält.

pNoteFunc

[in] Name der Callback-Funktion.

hUser

[in] 32-Bit Wert, welcher an die Callback-Funktion übergeben wird.

pNotification

[out] Adresse der Variablen, die das Handle der Notification aufnimmt.

Rückgabewert

Gibt den Fehlerstatus der Funktion zurück.

Limitierung :

Pro ADS-Port steht eine begrenzte Anzahl von 550 Notifikations zur Verfügung.

Anmerkungen

Wird der TwinCAT-Router gestoppt und wieder gestartet, so sind die Notifications ungültig. Mit der Funktion AdsAmsRegisterRouterNotification() können Sie dieses Ereignis abfangen.

Beispiel

Siehe Beispiel 8: Ereignisgesteuertes Lesen