2.1.6. ceGnSearchDevice


SYNOPSIS

VT_I4 ceGnSearchDevice(
  VT_I4 RealNode,
  DWORD nTimeout,
  VT_I4 IsBlocking,
  VT_PI4 pResultNode
)

DESCRIPTION

  • 라이브러리 구동 초기화 상태에서 원격 노드의 정보를 탐색합니다. 일반적인 응용 프로그램의 메인 프로그램에서 이 함수를 통해 원격 노드를 탐색하고, 다른 프로그램에서는 이미 검색된 정보를 참조하게

  • 됩니다.

PARAMETER

  • RealNode : 실제 탐색(Search)할 원격 노드의 수를 설정합니다. RealNode 의 개수는 탐색할 원격. 노드의 개수보다 같거나 커야 합니다.

  • nTimeout : 원격 노드 탐색(Search) 시간을 밀리초(ms) 단위로 설정합니다. 1 개의 원격 노드를. 탐색하는데 걸리는 최소 시간은 30ms 입니다. 최소 탐색 시간은 다음과 같습니다.

원격 노드 개수

탐색 시간

1개

30ms*1 = 30ms

2개

30ms*2 = 60ms

3개

30ms*3 = 90ms

  • IsBlocking : 완료될 때까지 기다리는 동안 윈도우 메시지를 블록(Blocking)할 것인지를 결정합니다.

Value

Meaning

0 (CE_FALSE)

블록(Blocking)을 하지 않습니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에도 윈도우 이벤트를 처리합니다.

1 (CE_TRUE)

블록 (Blocking)을 합니다. 따라서 원격 노드 정보 탐색이 완료되는 동안에는 윈도우 이벤트가 처리되지 않습니다.

  • pResultNode : 이 매개변수를 통하여 탐색된 원격 노드의 개수를 반환합니다.

RETURN VALUE

Value

Meaning

음수

수행 실패. 자세한 나용은 ‘에러 처리’ 편을 참고합니다.

0 (ceERR_NONE)

수행 성공