System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
See also
GetTagChar example (Page 1495)
Functionality of the GetTag functions (Page 1355)
GetTagDouble
Function
Determines the value of a tag of data type "64-bit floating point value".
Syntax
double GetTagDouble(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "double"
See also
GetTagFloat example (Page 1497)
Functionality of the GetTag functions (Page 1355)
GetTagDWord
Function
Determines the value of a tag of data type "unsigned 32 bit".
Syntax
DWORD GetTagDWord(Tag Tag_Name);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1411
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "DWORD"
See also
GetTagWord example (Page 1505)
Functionality of the GetTag functions (Page 1355)
GetTagFloat
Function
Determines the value of a tag of data type "32-bit floating point value".
Syntax
float GetTagFloat(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "float".
See also
GetTagFloat example (Page 1497)
Functionality of the GetTag functions (Page 1355)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1412
System Manual, 11/2008,
GetTagRaw
Function
Determines the value of a tag of data type "Raw data type".
Syntax
BOOL GetTagRaw(Tag Tag_Name, BYTE* pValue, DWORD size);
Parameters
Tag_Name
name of the tag
pValue
The pointer to a byte field which contains the value of the raw data tag
size
Size of the byte field in bytes
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
See also
GetTagRaw example (Page 1502)
Functionality of the GetTag functions (Page 1355)
GetTagSByte
Function
Determines the value of a tag of data type "signed 8 bit".
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1413
Syntax
signed char GetTagSByte(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
The value of the tag in the data type "signed char"
See also
GetTagSByte example (Page 1504)
Functionality of the GetTag functions (Page 1355)
GetTagSDWord
Function
Determines the value of a tag of data type "signed 32 bit".
Syntax
long GetTagSDWord(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "long"
See also
GetTagSByte example (Page 1504)
Functionality of the GetTag functions (Page 1355)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1414
System Manual, 11/2008,
GetTagSWord
Function
Determines the value of a tag of data type "signed 16 bit".
Syntax
short GetTagSWord(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "short"
See also
GetTagSByte example (Page 1504)
Functionality of the GetTag functions (Page 1355)
GetTagValue
Function
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result
structure containing the value.
Syntax
BOOL GetTagValue(LPDM_VARKEY lpdmVarKey, LPDM_VAR_UPDATE_STRUCT
lpdmresult, LPCMN_ERROR lpdmError);
Parameters
lpdmVarKey
Pointer to a structure of the data type "DM_VARKEY"
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1415
lpdmresult
Pointer to the value from data type "DM_VAR_UPDATE_STRUCT"
lpdmError
Pointer to the structure which contains the error description
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
See also
Structure definition CMN_ERROR (Page 1546)
Structure definition DM_VAR_UPDATE_STRUCT (Page 1548)
Structure definition DM_VARKEY (Page 1550)
Functionality of the GetTag functions (Page 1355)
GetTagWord
Function
Determines the value of a tag of data type "unsigned 16 bit".
Syntax
WORD GetTagWord(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "WORD"
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1416
System Manual, 11/2008,
See also
GetTagWord example (Page 1505)
Functionality of the GetTag functions (Page 1355)
3.3.5.3 set
Principle of the SetTag functions
SetTagXXX
The SetTagXXX function assigns the job a value to write and returns immediately to the caller.
In this case, the system does not wait until value is actually written.
The call is marked by the following:
● The call is fast.
● The caller does not know when the value is actually written.
● The function provides no information on the state of the write job.
SetTagXXXWait
The function SetTagXXXWait assigns the job of writing a value and will first return to the caller
when the value has actually been written.
The call is marked by the following:
● The call takes longer in comparison to SetTagXXX. The duration is also dependent on the
channel and AS, amongst other things.
● The value is written after the call.
● The function provides no information on the state of the write job.
SetTagXXXState
The function SetTagXXXState has the same features as SetTagXXX; plus the function returns
information regarding the status of the write request.
Since the status is always provided internally, there is no performance difference compared
to SetTagXXX.
SetTagXXXStateWait
The function SetTagXXXStateWait has the same features as SetTagXXXWait; plus the
function returns information regarding the status of the write request.
Since the status is always provided internally, there is no performance difference compared
to SetTagXXXWait.
The difference between the functions SetTagXXXStateWait and SetTagXXXState
corresponds to the difference between SetTagXXXWait and SetTagXXX.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1417
Note, that certain statuses can only be generated when the write process has been completed.
SetTagMultiWait
The SetTagMultiWait function has the same features as SetTagXXXWait. It also offers the
option of granting several write jobs in a single job.
state
wait
SetTagBitStateWait
Function
Sets the value of a tag of data type "Binary tag". The function is ended after the AS has
acknowledged acceptance of the value. The status of the tag is also returned.
Principle of the SetTag
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130
Syntax
BOOL SetTagBitStateWait(Tag Tag_Name, short value, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
value
Value of the tag in the data type "short"
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1418
System Manual, 11/2008,
Return value
TRUE
The function itself has been completed without any errors.
However, no test is made as to whether the tag could be written without errors. To do this, the
tag status must be evaluated.
FALSE
An error has occurred.
See also
Tag statuses (Page 1543)
Beispiel SetTagBitStateWait (Page 1522)
SetTagByteStateWait
Function
Sets the value of a tag of the data type "unsigned 8 Bit". The function is ended after the AS
has acknowledged acceptance of the value. The status of the tag is also returned.
Principle of the SetTag
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130
Syntax
BOOL SetTagByteStateWait(Tag Tag_Name, BYTE value, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
value
Value of the tag in the data type "BYTE"
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1419
Return value
TRUE
The function itself has been completed without any errors.
However, no test is made as to whether the tag could be written without errors. To do this, the
tag status must be evaluated.
FALSE
An error has occurred.
See also
Tag statuses (Page 1543)
Beispiel SetTagWordStateWait (Page 1529)
SetTagCharStateWait
Function
Sets the value of a tag of the data type " 8-bit text tag" or "16-bit text tag". The function is ended
after
the AS has acknowledged acceptance of the value. The status of the tag is also returned.
Principle of the SetTag
functionsEXAMPLE_INTERNAL_FUNCTIONS_TAG_STATEWAIT_23_130
Syntax
BOOL SetTagCharStateWait(Tag Tag_Name, LPSTR value, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
value
Value of the tag in the data type "LPSTR"
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1420
System Manual, 11/2008,