FP_ChangeAdviseState
| IAStatus FP_ChangeAdviseState | (IAHandle serverHandle, IATaskID taskID, IABoolean callbackState); |
Purpose
This function resumes or suspends user callbacks on all advise tasks or a specified advise task. The advise operation does not stop, and FP_ReadCache still returns the last known valid data on the I/O point.
Use this function to disable callbacks to your callback function without stopping the advise operation on an I/O point.
Parameter List
| Name | Type | Description |
|---|---|---|
| serverHandle | IAHandle | Handle to a specific server session. Create the handle with FP_Open. |
| taskID | IATaskID | Task ID of the advise operation to enable or disable the callback. Enter zero to change the state of all current advise operations. FP_Advise returns this value when you initiate the advise operation. taskID remains valid after this function. |
| callbackState | IABoolean | Enables or disables user callbacks for advise operations you specified.
Valid Range: (0) FALSE - Resume : Enable callbacks (1) TRUE - Suspend : Disable callbacks |
Return Value
The LabWindows/CVI manager or the server can return the following status codes. FP_ErrorMsg converts the status codes into descriptive strings.
| LabWindows/CVI Manager-Level Error Codes | 0x8480 IA_MGR_ERROR 0x8484 IA_MGR_SERVER_NOT_LOADED 0x8487 IA_MGR_INVALID_SERVER_HND 0x8488 IA_MGR_INVALID_TASK_ID |
| FieldPoint Server-Level Standard Error Codes | 0x8000 to 0x83FF |
Refer to the error section in your server help file for more information.