System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Pointer to the value of the tag in the data type "char"
See also
Tag statuses (Page 1543)
Beispiel GetTagCharStateWait (Page 1497)
Functionality of the GetTag functions (Page 1355)
GetTagDoubleState
Function
Determines the value of a tag of data type "64-bit floating point value". The status of the tag
is also returned.
Syntax
double GetTagDoubleState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
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,
1371
Return value
Value of the tag in the data type "double"
See also
Tag statuses (Page 1543)
GetTagFloatStateWait example (Page 1498)
Functionality of the GetTag functions (Page 1355)
GetTagDWordState
Function
Determines the value of a tag of data type "unsigned 32 bit". The status of the tag is also
returned.
Syntax
DWORD GetTagDWordState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Value of the tag in the data type "DWORD"
See also
Tag statuses (Page 1543)
GetTagWordStateWait example (Page 1507)
Functionality of the GetTag functions (Page 1355)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1372
System Manual, 11/2008,
GetTagFloatState
Function
Determines the value of a tag of data type "32-bit floating point value". The status of the tag
is also returned.
Syntax
float GetTagFloatState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Value of the tag in the data type "float"
See also
GetTagFloatStateWait example (Page 1498)
Tag statuses (Page 1543)
Functionality of the GetTag functions (Page 1355)
GetTagRawState
Function
Determines the value of a tag of data type "Raw data type". The status of the tag is also
returned.
Syntax
BOOL GetTagRawState(Tag Tag_Name, BYTE* pValue, DWORD size, PDWORD
lp_dwstate);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1373
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
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
See also
Tag statuses (Page 1543)
GetTagRawStateWait example (Page 1503)
Functionality of the GetTag functions (Page 1355)
GetTagSByteState
Function
Determines the value of a tag of data type "signed 8 bit". The status of the tag is also returned.
Syntax
signed char GetTagSByteState(Tag Tag_Name, PDWORD lp_dwstate);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1374
System Manual, 11/2008,
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
The value of the tag in the data type "signed char"
See also
Tag statuses (Page 1543)
GetTagSByteStateWait example (Page 1505)
Functionality of the GetTag functions (Page 1355)
GetTagSDWordState
Function
Determines the value of a tag of data type "signed 32 bit". The status of the tag is also returned.
Syntax
long GetTagSDWordState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Value of the tag in the data type "long"
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1375
See also
Tag statuses (Page 1543)
GetTagSByteStateWait example (Page 1505)
Functionality of the GetTag functions (Page 1355)
GetTagSWordState
Function
Determines the value of a tag of data type "signed 16 bit". The status of the tag is also returned.
Syntax
short GetTagSWordState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Value of the tag in the data type "short"
See also
Tag statuses (Page 1543)
GetTagSByteStateWait example (Page 1505)
Functionality of the GetTag functions (Page 1355)
GetTagWordState
Function
Determines the value of a tag of data type "unsigned 16 bit". The status of the tag is also
returned.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1376
System Manual, 11/2008,
Syntax
WORD GetTagWordState(Tag Tag_Name, PDWORD lp_dwstate);
Parameters
Tag_Name
name of the tag
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
Return value
Value of the tag in the data type "WORD"
See also
Tag statuses (Page 1543)
GetTagWordStateWait example (Page 1507)
Functionality of the GetTag functions (Page 1355)
stateqc
wait
GetTagBitStateQCWait
Function
Determines the value of a tag of data type "Binary tag". The value is read explicitly from the
AS. In addition, the status and the quality code of the tags are returned.
Syntax
BOOL GetTagBitStateQCWait(Tag Tag_Name, PDWORD lp_dwstate, PDWORD
pdwQualityCode);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1377
Parameters
Tag_Name
Name of the tag.
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
pdwQualityCode
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete.
Return value
Value of the tags in the data type "BOOL".
See also
Tag statuses (Page 1543)
GetTagWordStateQCWait example (Page 1506)
Functionality of the GetTag functions (Page 1355)
GetTagByteStateQCWait
Function
Determines the value of a tag of data type "unsigned 8 bit". The value is read explicitly from
the AS. In addition, the status and the quality code of the tags are returned.
Syntax
BYTE GetTagByteStateQCWait(Tag Tag_Name, PDWORD lp_dwstate, PDWORD
pdwQualityCode);
Parameters
Tag_Name
Name of the tag.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1378
System Manual, 11/2008,
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
pdwQualityCode
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete.
Return value
Value of the tag in the data type "BYTE".
See also
Tag statuses (Page 1543)
GetTagWordStateQCWait example (Page 1506)
Functionality of the GetTag functions (Page 1355)
GetTagCharStateQCWait
Function
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The value is read
explicitly from the AS. In addition, the status and the quality code of the tags are returned.
Syntax
char* GetTagCharStateQCWait(Tag Tag_Name, PDWORD lp_dwstate, PDWORD
pdwQualityCode);
Parameters
Tag_Name
Name of the tag.
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
pdwQualityCode
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1379
Return value
Pointer to the value of the tag in data type "char".
See also
Tag statuses (Page 1543)
GetTagCharStateQCWait example (Page 1496)
Functionality of the GetTag functions (Page 1355)
GetTagDoubleStateQCWait
Function
Determines the value of a tag of data type "64-bit floating point value". The value is read
explicitly from the AS. In addition, the status and the quality code of the tags are returned.
Syntax
double GetTagDoubleStateQCWait(Tag Tag_Name, PDWORD lp_dwstate, PDWORD
pdwQualityCode);
Parameters
Tag_Name
Name of the tag.
lp_dwstate
Pointer to a DWORD in which the status of the tag is stored after the function has been
completed.
pdwQualityCode
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete.
Return value
Value of the tag in the data type "double".
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1380
System Manual, 11/2008,