AmsNetId

Eigenschaft (Property), die die AmsNetId des betreffenden TwinCAT Systems als String zurückliefert.

HRESULT AmsNetId(
  [out,retval] BSTR* pVal,
);

Parameters

pVal	[out, retval] In pVal wird die 6 Byte AmsNetId als Basic String (BSTR) zurückgeliefert.

Return Values

HRESULT == S_OK	Lesen erfolgreich durchgeführt.
HRESULT != S_OK	Fehler beim Lesen der AmsNetId.

Bemerkungen

Nach dem Aufruf von AmsNetId steht die AmsNetId als Zeichenkette zur Verfügung. Der Speicher für die Zeichenkette wird vom System zur Verfügung gestellt und muss nicht von der Aufrufen Applikation alloziert werden. Wird diese Methode von C bzw. C++ ohne "Wrapper" Funktionen aufgerufen, so ist die aufrufende Applikation dafür verantwortlich den Speicher mit SysFreeString wieder freizugeben.