Dp_Get_Cref - Siemens SIMATIC NET CP 5613 Handbuch

Beschreibung der einzelnen DP-Funktionen und Daten sowie Fehlercodes

4.1.21 DP_get_cref

Zweck
Diese Funktion ermittelt aus der Slave-Adresse und dem user_handle die c_ref für
die DPC1-Funktionen. Die c_ref muss dort in der Struktur DPC1_REQ_S als Vor-
gabeparameter eingetragen werden.
Hinweis
Die c_ref für einen Slave muss nur einmal ermittelt werden. Es ist nicht erforder-
lich, vor jeder DPC1-Funktion DP_get_cref erneut aufzurufen.
Syntax
DPR_DWORD
Parameter
Name
user_handle
c_ref
slv_add
error
Return-Wert
Name
DP_OK
andere
122
DP_get_cref (DPR_DWORD
DPR_WORD
DPR_DWORD
DP_ERROR_T *error );
User-Handle, das beim Aufruf DP_open vergeben wurde.
Nach erfolgreichem Abschluss der Funktion enthält *c_ref
die angeforderte Referenz.
Slave-Adresse
Adresse einer vom Anwenderprogramm bereitgestellten
Struktur vom Typ DP_ERROR_T - Die Struktur enthält im
Fehlerfall Details zur Fehlerursache (siehe Kapitel 4.4).
Die c_ref konnte ermittelt werden.
Fehlerhafter Abschluss der Funktion, keine Quittung verfüg-
bar
Programmierschnittstelle DP-Base für CP 5613/CP 5614
user_handle,
slv_add,
*c_ref,
Beschreibung
Beschreibung
C79000-G8900-C139-04
// in
// in
// out
// out