System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
See also
Tag statuses (Page 1543)
GetTagFloatStateQCWait example (Page 1498)
Functionality of the GetTag functions (Page 1355)
GetTagDWordStateQCWait
Function
Determines the value of a tag of data type "unsigned 32 bit". The value is read explicitly from
the AS. In addition, the status and the quality code of the tags are returned.
Syntax
DWORD GetTagDWordStateQCWait(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 "DWORD".
See also
Tag statuses (Page 1543)
GetTagWordStateQCWait example (Page 1506)
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,
1381
GetTagFloatStateQCWait
Function
Determines the value of a tag of data type "32-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
float GetTagFloatStateQCWait(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 "float".
See also
Tag statuses (Page 1543)
GetTagFloatStateQCWait example (Page 1498)
Functionality of the GetTag functions (Page 1355)
GetTagMultiStateQCWait
Function
The values, states and quality codes are determined for several tags and are stored in the
respective addresses in the specified format. The values are read explicitly from the AS.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1382
System Manual, 11/2008,
The function must be provided with two DWORD arrays, the member of which contains the
states and quality codes of the individual tags after the function has been called. The size of
the arrays must be selected so that sufficient memory space is available for these statuses.
Syntax
BOOL GetTagMultiStateQCWait(DWORD* pdwState, DWORD* pdwQualityCode, const char*
pFormat)
Parameters
pdwState
Field in which the status of the individual tags is stored after the function has been completed.
pdwQualityCode
Field in which the quality codes of the individual tags is stored after the function has been
completed.
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.
See also
Format descriptors (Page 1538)
Tag statuses (Page 1543)
GetTagMultiStateQCWait example (Page 1499)
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,
1383
GetTagRawStateQCWait
Function
Determines the value of a tag of data type "Raw data type". The value is read explicitly from
the AS. In addition, the status and the quality code of the tags are returned.
Syntax
BOOL GetTagRawStateQCWait(Tag Tag_Name, BYTE pValue, DWORD size, PDWORD
lp_dwstate, PDWORD pdwQualityCode);
Parameters
Tag_Name
Name of the tag.
pValue
Pointer to a byte field containing 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.
pdwQualityCode
Pointer to a DWORD in which the quality code of the tag is stored after the function is complete.
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)
1384
System Manual, 11/2008,
See also
Tag statuses (Page 1543)
GetTagRawStateQCWait example (Page 1503)
Functionality of the GetTag functions (Page 1355)
GetTagSByteStateQCWait
Function
Determines the value of a tag of data type "signed 8 bit". The value is read explicitly from the
AS. In addition, the status and the quality code of the tags are returned.
Syntax
signed char GetTagSByteStateQCWait(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 "signed char".
See also
Tag statuses (Page 1543)
GetTagSByteStateQCWait 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)
System Manual, 11/2008,
1385
GetTagSDWordStateQCWait
Function
Determines the value of a tag of data type "signed 32 bit". The value is read explicitly from the
AS. In addition, the status and the quality code of the tags are returned.
Syntax
long GetTagSDWordStateQCWait(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 tags in the data type "long".
See also
Tag statuses (Page 1543)
GetTagSByteStateQCWait example (Page 1504)
Functionality of the GetTag functions (Page 1355)
GetTagSWordStateQCWait
Function
Determines the value of a tag of data type "signed 16 bit". The value is read explicitly from the
AS. In addition, the status and the quality code of the tags are returned.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1386
System Manual, 11/2008,
Syntax
short GetTagSWordStateQCWait(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 "short".
See also
Tag statuses (Page 1543)
GetTagSByteStateQCWait example (Page 1504)
Functionality of the GetTag functions (Page 1355)
GetTagValueStateQCWait
Function
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result
structure
containing the value. The value is read explicitly from the AS. In addition, the status
and the quality code of the tags are returned.
Syntax
BOOL GetTagValueStateQCWait(LPDM_VARKEY lpdmVarKey,
LPDM_VAR_UPDATE_STRUCTEX lpdmresult, LPCMN_ERROR lpdmError);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1387
Parameters
lpdmVarKey
Pointer to a structure of the data type "DM_VARKEY"
lpdmresult
Pointer to the value from data type "DM_VAR_UPDATE_STRUCTEX"
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_STRUCTEX (Page 1549)
Structure definition DM_VARKEY (Page 1550)
Functionality of the GetTag functions (Page 1355)
GetTagWordStateQCWait
Function
Determines the value of a tag of data type "unsigned 16 bit". The value is read explicitly from
the AS. In addition, the status and the quality code of the tags are returned.
Syntax
WORD GetTagWordStateQCWait(Tag Tag_Name, PDWORD lp_dwstate, PDWORD
pdwQualityCode);
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1388
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.
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 "WORD".
See also
Tag statuses (Page 1543)
GetTagWordStateQCWait example (Page 1506)
Functionality of the GetTag functions (Page 1355)
GetTagBitStateQC
Function
Determines the value of a tag of data type "Binary tag". In addition, the status and the quality
code of the tags are returned.
Syntax
BOOL GetTagBitStateQC(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)
System Manual, 11/2008,
1389
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)
GetTagBitStateQC example (Page 1494)
Functionality of the GetTag functions (Page 1355)
GetTagByteStateQC
Function
Determines the value of a tag of data type "unsigned 8 bit". In addition, the status and the
quality code of the tags are returned.
Syntax
BYTE GetTagByteStateQC(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.
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1390
System Manual, 11/2008,