System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
Return value
Value of the tag in the data type "BYTE"
See also
Tag statuses (Page 1543)
GetTagWordStateWait example (Page 1507)
Functionality of the GetTag functions (Page 1355)
GetTagCharStateWait
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. The status of the tag is also returned.
Syntax
char* GetTagCharStateWait(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
Pointer to the value of the tag in the data type "char"
See also
Functionality of the GetTag functions (Page 1355)
Tag statuses (Page 1543)
Beispiel GetTagCharStateWait (Page 1497)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1361
GetTagDoubleStateWait
Function
Determines the value of a tag of data type "64-bit floating point value". The value is read
explicitly from the AS. The status of the tag is also returned.
Syntax
double GetTagDoubleStateWait(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 "double"
See also
Tag statuses (Page 1543)
GetTagFloatStateWait example (Page 1498)
Functionality of the GetTag functions (Page 1355)
GetTagDWordStateWait
Function
Determines the value of a tag of data type "unsigned 32 bit". The value is read explicitly from
the AS. The status of the tag is also returned.
Syntax
DWORD GetTagDWordStateWait(Tag Tag_Name, PDWORD lp_dwstate);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1362
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
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)
GetTagFloatStateWait
Function
Determines the value of a tag of data type "32-bit floating point value". The value is read
explicitly from the AS. The status of the tag is also returned.
Syntax
float GetTagFloatStateWait(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,
1363
Return value
Value of the tag in the data type "float"
See also
Tag statuses (Page 1543)
GetTagFloatStateWait example (Page 1498)
Functionality of the GetTag functions (Page 1355)
GetTagMultiStateWait
Function
The values and states of several tags are established and stored in the corresponding
addresses in the specified format. The values are read explicitly from the AS.
The function must transfer a DWORD array whose members contain the individual tag states
after
the function is invoked. The size of the array must be selected so that sufficient memory
space is available for these statuses.
Syntax
BOOL GetTagMultiStateWait(DWORD* pdwState, const char* pFormat)
Parameters
pdwState
Field in which the tag statuses are stored.
pFormat
Format description for all requested tags and for each tag name and address of the value
Return value
TRUE
The function has been completed without any errors.
FALSE
An error has occurred.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1364
System Manual, 11/2008,
See also
Format descriptors (Page 1538)
Tag statuses (Page 1543)
GetTagMultiStateWait example (Page 1500)
Functionality of the GetTag functions (Page 1355)
GetTagRawStateWait
Function
Determines the value of a tag of data type "Raw data type". The value is read explicitly from
the AS. The status of the tag is also returned.
Syntax
BOOL GetTagRawStateWait(Tag Tag_Name, BYTE pValue, DWORD size, PDWORD
lp_dwstate);
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.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1365
FALSE
An error has occurred.
See also
Tag statuses (Page 1543)
GetTagRawStateWait example (Page 1503)
Functionality of the GetTag functions (Page 1355)
GetTagSByteStateWait
Function
Determines the value of a tag of data type "signed 8 bit". The value is read explicitly from the
AS. The status of the tag is also returned.
Syntax
signed char GetTagSByteStateWait(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
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)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1366
System Manual, 11/2008,
GetTagSDWordStateWait
Function
Determines the value of a tag of data type "signed 32 bit". The value is read explicitly from the
AS. The status of the tag is also returned.
Syntax
long GetTagSDWordStateWait(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"
See also
Tag statuses (Page 1543)
GetTagSByteStateWait example (Page 1505)
Functionality of the GetTag functions (Page 1355)
GetTagSWordStateWait
Function
Determines the value of a tag of data type "signed 16 bit". The value is read explicitly from the
AS. The status of the tag is also returned.
Syntax
short GetTagSWordStateWait(Tag Tag_Name, PDWORD lp_dwstate);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1367
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
Functionality of the GetTag functions (Page 1355)
Tag statuses (Page 1543)
GetTagSByteStateWait example (Page 1505)
GetTagWordStateWait
Function
Determines the value of a tag of data type "unsigned 16 bit". The value is read explicitly from
the AS. The status of the tag is also returned.
Syntax
WORD GetTagWordStateWait(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)
1368
System Manual, 11/2008,
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)
GetTagBitState
Function
Determines the value of a tag of data type "Binary tag". The status of the tag is also returned.
Syntax
BOOL GetTagBitState(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 "BOOL"
See also
Tag statuses (Page 1543)
GetTagBitStateWait example (Page 1495)
Functionality of the GetTag functions (Page 1355)
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1369
GetTagByteState
Function
Determines the value of a tag of data type "unsigned 8 bit". The status of the tag is also returned.
Syntax
BYTE GetTagByteState(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 "BYTE"
See also
Tag statuses (Page 1543)
GetTagWordStateWait example (Page 1507)
Functionality of the GetTag functions (Page 1355)
GetTagCharState
Function
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". The status of the
tag is also returned.
Syntax
char* GetTagCharState(Tag Tag_Name, PDWORD lp_dwstate);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1370
System Manual, 11/2008,