ClosePort Method - intrepidcs API
C/C++ declare - VB declare - VB.NET declare - C# declare - Parameters - Return Values - Remarks - C/C++ example - VB example - VB.NET example - C# example

This method closes the communication link with the neoVI hardware.

C/C++ Declare

int _stdcall icsneoClosePort(int hObject, int * pNumberOfErrors);

Visual Basic Declare

Public Declare Function icsneoClosePort Lib "icsneo40.dll" (ByVal hObject As Long, ByRef pNumberOfErrors As Long) As Long


Visual Basic .NET Declare

Public Declare Function icsneoClosePort Lib "icsneo40.dll" (ByVal hObject As Int32, ByRef pNumberOfErrors As Int32) As Int32


C# Declare

[DllImport("icsneo40.dll")]
public static extern Int32 icsneoClosePort(Int32 hObject, ref Int32 pNumberOfErrors);


Parameters

hObject
    [in] Specifies the driver object created by OpenNeoDevice.

pNumberOfErrors
    [out] Specifies the number of errors in the neoVI DLL error queue. You can read out the errors by calling the GetErrorMessages method.

Return Values

If the port has been closed successfully the return value will be 1. Otherwise,  it will return zero. It will also return zero if the port is already closed.

Remarks

Must be called once for each successful call to OpenNeoDevice or memory and resource leaks will occur.

Examples

Visual Basic Example

Private m_hObject As Long '// Declared at form level and previously open with a call to OpenNeoDevice

Dim lResult As Long
Dim lNumberOfErrors As Long

'//close the port
lResult = icsneoClosePort(m_hObject, lNumberOfErrors)
If CBool(lResult) Then
    MsgBox("Port Closed OK!", vbOKOnly)
Else
    MsgBox("Problem Closing Port", vbOKOnly)
End If


C/C++ Example

int lNumberOfErrors;    // used to get the number of errors
int iResult;

// Close Communication
iResult = icsneoClosePort(hObject, &iNumberOfErrors);
// Test the Result
if (iResult== 0)
    MessageBox(hWnd,TEXT("Problem Closing Port"),TEXT("neoVI Example"),0);
else
    MessageBox(hWnd,TEXT("Port Closed Successfully"),TEXT("neoVI Example"),0);

C# Example

//Declared at form level and previously open with a call to OpenNeoDevice
int m_hObject; //handle for device,

int iResult;
int iNumberOfErrors = 0;

//close the port
iResult = icsNeoDll.icsneoClosePort(m_hObject, ref iNumberOfErrors);
if (iResult == 1)
{
    MessageBox.Show("Port Closed OK!");
}
else
{
    MessageBox.Show("Problem ClosingPort");
}
m_bPortOpen = false;


Visual Basic .NET Example

Private m_hObject As Integer '// Declared at form level and previously open with a call to OpenNeoDevice

Dim iResult As Integer
Dim iNumberOfErrors As Integer

'//close the port
iResult = icsneoClosePort(m_hObject, iNumberOfErrors)
If CBool(iResult) Then
    MsgBox("Port Closed OK!")
Else
    MsgBox("Problem Closing Port")
End If
 
intrepidcs API Documentation - (C) Copyright 2000-2009 Intrepid Control Systems, Inc.  (www.intrepidcs.com)

Last Updated : Tuesday, December 16, 2008