2.1.15. ceGnUnSearchDevice¶

SYNOPSIS¶

VT_I4 ceGnUnSearchDevice[none] VT_EMPTY

DESCRIPTION¶

원격 노드 탐색 결과를 초기화 하며, 이 함수가 수행된 이후 ceGnSearchDevice 함수를 통해 원격 노드 탐색을 수행할 수 있습니다.
ceGnIsSearched 함수를 통해 원격 노드가 탐색된 상태인지 확인할 수 있습니다. 원격 노드 탐색 전이면 ceGnSearchDevice 함수를, 원격 노드 탐색 후라면 ceGnReSearchDevice 함수를 사용하시면 됩니다.

RETURN VALUE¶

Value	Meaning
음수	수행 실패. 자세한 나용은 ‘에러 처리’ 편을 참고합니다.
0 (ceERR_NONE)	수행 성공

Note

이 함수는 원격 노드의 탐색 결과를 초기화 하는 함수입니다. 원격 노드 정보 초기화는 다른 cEIP 응용 프로그램에 영향을 주므로 ceGnReSearchDevice 함수를 통해 탐색된 정보를 얻어오시기 바랍니다.

Example¶

C/C++
#include “ceSDK.h”
#include “ceSDKDef.h”

#define REALNODE 10
#define TIMEOUT 1000
long nIsSearchedDevice; // 탐색된 원격 노드 정보
long nNodeCount; // 원격 노드 탐색 여부 정보
long nRetVal;
// 원격 노드 탐색 여부를 확인 합니다.
ceGnIsSearchedDevice ( &nIsSearchedDevice );
// 원격 노드 탐색 여부를 확인하여 원격 노드의 정보를 탐색합니다.
if ( nIsSearchedDevice == CE_TRUE ) // 원격 노드 탐색이 수행 되었습니다.
{
ceGnUnSearchDevice (); // 원격 노드 탐색 결과를 초기화 합니다.
/* 이 함수는 원격 노드의 탐색 결과를 초기화 하는 함수입니다. 이 함수 호출 시 다른 cEIP
응용 프로그램에 영향을 주므로, 원격 노드를 재 탐색할 필요가 있을 경우 명시적으로 본 함수를
호출하지 않고, ceGnReSearchDevice 함수를 통해 재 탐색 하여 주시기 바랍니다. */
if (ceGnSearchDevice ( REALNODE, TIMEOUT, CE_FALE, &nNodeCount ) != ceERR_NONE )
{
// 적절한 에러 처리를 수행하여 주시기 바랍니다.
}
}