SAString::LockBuffer

SAChar *LockBuffer( );

Return value

A pointer to a SAString object or null-terminated string.

Remarks

Call this member function to lock a string in the buffer.

By calling LockBuffer, you create a copy of the string, and then set the reference count to -1. When the reference count is set to -1, the string in the buffer is considered to be in a "locked" state.  While in a locked state, the string is protected in two ways:

• No other string can get a reference to the data in the locked string, even if that string is assigned to the locked string.
  
  
• The locked string will never reference another string, even if that other string is copied to the locked string.

By locking the string in the buffer, you ensure that the string’s exclusive hold on the buffer will remain intact.

After you have finished with LockBuffer, call UnlockBuffer to reset the reference count to 1.

Server specific notes

No specific information.

See also

UnlockBuffer

Problems and Questions

If you haven't found the answer to your questions or have some problems on using the Library, please, send e-mail to howto@sqlapi.com.