Overview#NOTE: NMAS connections apparently bypass this code.
If an application relies on the workstation being logged in, NWDSOpenMonitoredConn can be an effective API to use. It will fail if the workstation is not logged in and it will always return a connection to a server with a read/write replica to the logged in object. This will be a performance enhancement if the application is going to work with the logged in user object.
What is a monitored connection ?#NWDSLogin creates a 'Monitored Connection' so DS can track such things as concurrent logins of the same user from multiple sessions or workstations, and login time restrictions, etc. This allows DS to let a user authenticate to as many servers as needed without breaching the concurrent login restrictions.
Because NWDSLogins are relative to a NDSTree, the 'Monitored Connection' created is relative to the NDSTree. A workstation (user) therefore will have a 'Monitored Connection' for every tree it is currently logged into.
However, with the NMAS login methods, like Universal Password, this call is typically bypassed.