AppendBasisTail

AppendBasisTail(
 string_t pBasisName,
 int tail
 )

This service inserts a numeric tail into a 'basis' name previously constructed by calling the CreateBasis service. If the numeric tail (which is always a single-byte encoding), when appended to the primary name of the basis results in a primary name that is longer than 8 bytes, the primary name is truncated from the right until the truncated primary name with the numeric tail fits in an 8-byte multi-byte OEM string. This routine takes care of multi-byte encodings while generating the basis name and ensures that when the unicode basis name is converted into a BCS string, the primary name will still not exceed 8 bytes. A typical numeric tail has the form '~xxx' where xxx stands for the numeric value the tail is to be generated from.

pBasisName

Supplies a flat pointer to the basis name into which the numeric tail needs to be inserted.

tail

Supplies the value of the numeric tail that needs to be inserted.

• Returns 0 if the insertion failed because an invalid value was given for the numeric tail. Returns a non-zero value if the numeric tail was successfully inserted.