DSUnbind
int DSUnbind (int panelHandle, int controlID, HRESULT *dataSocketError);
Purpose
Unbinds a control from a DataSocket object and frees the resources used by it.
 |
Note This function is not supported for 64-bit applications. |
(Linux) This function is not supported.
If the control being unbound is a graph, and you did not specify a plotID at the time the graph was bound, LabWindows/CVI deletes the plot. If the graph is in discard mode, the plot will not be deleted.
Supported Controls
You can use DSUnbind with the following controls:
Parameters
| Input | ||
| Name | Type | Description |
| panelHandle | int | Specifier for a particular panel that is currently in memory. You can obtain this handle from functions such as LoadPanel and NewPanel. |
| controlID | int | The defined constant, located in the .uir header file, that you assigned to the control in the User Interface Editor, or the ID returned by functions such as NewCtrl and DuplicateCtrl. |
| Output | ||
| Name | Type | Description |
| dataSocketError | HRESULT | The HRESULT if this function causes a DataSocket error. A value of NULL can be passed in if the HRESULT is not needed. In the event of a DataSocket error, this function returns a value of UIEDataSocketError. |
Return Value
| Name | Type | Description |
| status | int | Return value indicating whether the function was successful. A negative number indicates that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 7.0 and later
Example
Refer to userint\databinding.cws for an example of using the DSUnbind function.