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

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

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