AdsSyncWriteControlReqEx

Ändert den ADS-Status und den Geräte-Status von einem ADS-Server.

LONG AdsSyncWriteControlReqEx(
  LONG      port,
  PAmsAddr  pAddr,
  USHORT    nAdsState,
  USHORT    nDeviceState,
  ULONG     nLength,
  PVOID     pData
);

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.

nAdsState

[in] neuer ADS-Status.

nDeviceState

[in] neuer Geräte-Status.

nLength

[in] Länge der Daten in Byte.

pData

[in] Zeiger auf Daten die zusätzlich zum Ads-Gerät geschickt werden.

Rückgabewert

Gibt den Fehlerstatus der Funktion zurück.

Bemerkungen

Außer dem Ändern von dem ADS-Status und dem Geräte-Status, ist es zusätzlich noch möglich Daten zum ADS-Server zu schicken, um weitere Informationen zu übertragen. Bei den aktuellen ADS-Geräten (PLC, NC, ...) werden diese Daten nicht weiter ausgewertet. Jedes ADS-Gerät kann seinen aktuellen Zustand anderen ADS-Geräten mitteilen. Dabei wird unterschieden zwischen den Status des Gerätes selbst (DeviceState) und dem Status der ADS-Schnittstelle von dem ADS-Gerät (AdsState). Die möglichen Zustände, die die ADS-Schnittstelle annehmen kann, ist durch die ADS-Spezifikation festgelegt

Beispiel

Siehe Beispiel 6: SPS starten/stoppen.