Alocate new storage for and duplicate the specified string into that storage.
You MUST call p6ISafeString::strfree() to deallocate the string.
- See also:
- p6ISafeString::strfree()
- Parameters:
-
| pString | [in] A pointer to the string to dduplicate. |
| ppCopy | [out] The address of a P6R::P6CHAR * in which to a place a pointer to the newly allocated copy. |
- Returns:
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | pString or ppCopy is NULL |
P6R::eTooBig | The string was longer than P6SAFESTR_MAX_CCH characters. |
P6R::eNoMemory | There were not enough resources to allocate space for the copy of the string. |