System Manual: Siemens SIMATIC HMI (WinCCv7.0: Scripting VBS, ANSI-C, VBA)
Подождите немного. Документ загружается.
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)
GetTagCharStateQC
Function
Determines the value of a tag of data type "8-bit text tag" or "16-bit text tag". In addition, the
status and the quality code of the tags are returned.
Syntax
char* GetTagCharStateQC(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
Pointer to the value of the tag in data type "char".
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
System Manual, 11/2008,
1391
See also
Tag statuses (Page 1543)
GetTagCharStateQCWait example (Page 1496)
Functionality of the GetTag functions (Page 1355)
GetTagDoubleStateQC
Function
Determines the value of a tag of data type "64-bit floating point value". In addition, the status
and the quality code of the tags are returned.
Syntax
double GetTagDoubleStateQC(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)
1392
System Manual, 11/2008,
See also
GetTagFloatStateQCWait example (Page 1498)
Tag statuses (Page 1543)
Functionality of the GetTag functions (Page 1355)
GetTagDWordStateQC
Function
Determines the value of a tag of data type "unsigned 32 bit". In addition, the status and the
quality code of the tags are returned.
Syntax
DWORD GetTagDWordStateQC(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,
1393
GetTagFloatStateQC
Function
Determines the value of a tag of data type "32-bit floating point value". In addition, the status
and the quality code of the tags are returned.
Syntax
float GetTagFloatStateQC(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
GetTagFloatStateQCWait example (Page 1498)
Tag statuses (Page 1543)
Functionality of the GetTag functions (Page 1355)
GetTagRawStateQC
Function
Determines the value of a tag of data type "Raw data type". 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)
1394
System Manual, 11/2008,
Syntax
BOOL GetTagRawStateQC(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.
See also
Tag statuses (Page 1543)
GetTagRawStateQCWait example (Page 1503)
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,
1395
GetTagSByteStateQC
Function
Determines the value of a tag of data type "signed 8 bit". In addition, the status and the quality
code of the tags are returned.
Syntax
signed char GetTagSByteStateQC(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)
GetTagSDWordStateQC
Function
Determines the value of a tag of data type "signed 32 bit". 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)
1396
System Manual, 11/2008,
Syntax
long GetTagSDWordStateQC(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)
GetTagSWordStateQC
Function
Determines the value of a tag of data type "signed 16 bit". In addition, the status and the quality
code of the tags are returned.
Syntax
short GetTagSWordStateQC(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,
1397
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)
GetTagValueStateQC
Function
Enables the transfer of a value in the form of a variant. Establishes the pointer to the result
structure containing the value. In addition, the status and the quality code of the tags are
returned.
Syntax
BOOL GetTagValueStateQC(LPDM_VARKEY lpdmVarKey,
LPDM_VAR_UPDATE_STRUCTEX 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)
1398
System Manual, 11/2008,
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)
GetTagWordStateQC
Function
Determines the value of a tag of data type "unsigned 16 bit". In addition, the status and the
quality code of the tags are returned.
Syntax
WORD GetTagWordStateQC(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,
1399
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)
wait
GetTagBitWait
Function
Determines the value of a tag of data type "Binary tag". The value is read explicitly from the
AS.
Syntax
BOOL GetTagBitWait(Tag Tag_Name);
Parameters
Tag_Name
name of the tag
Return value
Value of the tag in the data type "BOOL"
ANSI-C function descriptions
3.3 Internal functions
MDM - WinCC: Scripting (VBS, ANSI-C, VBA)
1400
System Manual, 11/2008,