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) |
수행 성공 |