Extracts a the first token from a string described by a P6BWCSTR, where the tokens are delimited by the characters in pszDelimiters.
This method is an improvement over a traditional strtok() because it is reentrant, and over a traditional strsep() because is does not modify the string being tokenized.
- Parameters
-
| pbcsSearchIn | [ in out ] A pointer to a P6BWCSTR structure describing the string to be searched. On exit, the pString member pointer will be modified to point at the next character in the string to be searched or NULL. |
| pbsDelimiters | [ in ] A pointer to const P6BWCSTR NULL containing the set of character delimiters to be used to determine token boundaries. The "NULL" characted can be used in this set. |
| pbcsToken | [ out ] The address of a P6BWCSTR structure which on success will be populated with the tokens information. You MUST not assume that pbcsToken->pString will point into *ppszSearchIn. As a result, you MUST not use the pointer value returned in any pointer arithmetic. |
- Returns
