If the section name does not exist then the unnamed section is used as a default.
The contents of the entire section is returned in the following format: name=value\nname=value\nname=value\n...name=value\n\0 If pReturnBuf is not large enough to hold the entire section the error eTooSmall is returned. If pReturnBuf is set to NULL then pWritten is modified with the required buffer size to fit the entire section.
- Parameters
-
pSectionName | [ in ] Pointer to string defining the section's contents to get |
pReturnBuf | [ out ] Pointer to buffer to place the entire section's contents into |
cBuffer | [ in ] Number of characters in the buffer pointed to by pReturnBuf. |
pWritten | [ out ] Optional can be NULL, returns the number of characters written into pReturnBuf. This parameter cannot be NULL when pReturnBuf is also NULL. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eNoMemory | Insufficient memory to buffer section contents. |
P6R::eInvalidArg | If pReturnBuf and pWritten are both NULL. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |
P6R::eTooBig | The section values are too big to fit into ReturnBuf. |