INtime SDK Help
ntxFindINtimeNode
INtime SDK v7 > About INtime > INtime Kernel > System management calls > ntxFindINtimeNode

Specifies the kind of nodes that display in the INtime Node Browser.

This call starts an ActiveX interactive window where the user can select an INtime node.

NTXSTATUS ntxFindINtimeNode(
    LPTSTR lpszNodeName,
    DWORD dwLength,
    DWORD dwMask,
    LPCTSTR lpszInitial,
    LPDWORD lpdwState
);

Screenshot

 

Parameters

lpszNodeName
A pointer to the buffer that receives the name of the INtime node.
dwLength
The length (in bytes) of the lpszNodeName buffer.
dwMask
Specifies the kind of nodes that display in the browser. Valid values include:
Value Code Description
NODE_ACTIVE 0x01 Display Active Nodes
NODE_OFFLINE 0x02 Display Offline Nodes
NODE_CONFIG 0x04 Display Configured Nodes
NODE_LOCAL 0x08 Hide Local Nodes
NODE_REMOTE 0x10 Show only Local Nodes
NODE_DISCONNECTED 0x20 Display Disconnected Dynamic Nodes
NODE_DEFAULT 0x27 Show all nodes
lpszInitial
A string that specifies the node you want to select by default. You can leave this parameter as NULL.
lpdwState
The state of the selected node, if it is not NULL. Returned values include:
Value Description
ACTIVE_STATE RT nodes the browser currently can communicate with.
OFFLINE_STATE RT nodes the browser has but cannot currently communicate with.
CONFIG_STATE RT nodes the browser has not communicated with. These nodes may not exist.
DISCONNECTED_STATE RT nodes that are disconnected.

Return Values

E_OK
Success.
lpszNodeName does not contain the name of the selected node.
Failure. To determine the status, call ntxGetLastRtError.

Status

E_OK 0x0000
No exceptional conditions occurred.
E_STATE 0x0008
The node name is longer than the buffer can hold.
E_CONTEXT 0x0005
The Cancel button was pressed.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/nt/include/ntxbrow.h ntxbrow.h ntx.lib; ntxbrow.lib
INtime 4.01 (for 64-bit Windows) intime/nt/include/ntxbrow.h ntxbrow.h ntx64.lib; ntxbrow.lib
See Also