LockNullString - Allocate memory and fill it with 0-bytes |
Top Previous Next |
Syntax
<nAddress> := LockNullString( <nLen>, [<nType>] )
Parameters
<nLen>
Length (number of characters) of memory block to be filled with 0 characters.
<nType>
Type of string data to be assumed. This value can be STRINGTYPE_BINARY, STRINGTYPE_BINARY0, STRINGTYPE_TEXT, STRINGTYPE_UNICODETEXT. Passing STRINGTYPE_UNICODE for <nType> will allocate <nLen> * 2 bytes. Default is STRINGTYPE_BINARY.
Return value
Memory address of the block that was filled with zeroes.
Description
LockNullString allocates a memory block and fills it with zeroes. LockNullString always adds two extra 0-bytes in memory. This makes sure a C text string or a Unicode C text string is properly terminated.
To release the allocated memory block, use UnlockString or ReleaseLockString passing the returned address.
Classification
Core
Category
Quick Info
Library: cckptcor.lib / cckptcor.dll Header: StringTypes.ch
See also
Example
|