int Ns_WriteLockRWLock( Ns_RWLock *lock );
Ns_WriteLockRWLock acquires a write lock. Only one write lock can be in effect. If there are pending read locks active, the write lock acquisition blocks until all of the read locks drain. If a subsequent read lock acquisition attempt is made, the write lock has priority.
For general information about read/write locks and an example showing the use of the read/write lock functions, see the Ns_InitializeRWLock function.
Ns_RWLockWrLock is the preferred function for acquiring a write lock.