C API Reference -- Ns_WriteLockRWLock

### Ns_WriteLockRWLock

#### Overview

Acquire a write lock

#### Syntax

        int Ns_WriteLockRWLock(
        Ns_RWLock *lock
        );

#### Description

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.

#### See Also

Ns_InitializeRWLock

Ns_DestroyRWLock

Ns_ReadLockRWLock

Ns_ReadUnlockRWLock

Ns_WriteUnlockRWLock

Top of Page
Copyright © 1998-99 America Online, Inc.