DosInsertMessage - Parameters

pTable (PCHAR *) - input

A pointer table.

Each pointer filets to an ASCIIZ string or a double-byte character-set (DBCS) string ending in nulls. A maximum of nine strings can be present.

cTable (ULONG) - input

The number of variable insertion text strings.

Possible values range from 0 to 9. If cTable is 0, pTable is ignored.

pszMsg (PSZ) - input

The address of the input message.

cbMsg (ULONG) - input

The length, in bytes, of the input message.

pBuf (PCHAR) - output

The address of the caller's buffer area where the system returns the requested message.

If the message is too long to fit in the caller's buffer, then as much of the message text as possible is returned, with the appropriate error return code.

cbBuf (ULONG) - input

The length, in bytes, of the caller's buffer area.

pcbMsg (PULONG) - output

The length, in bytes, of the updated message returned.

ulrc (APIRET) - returns

Return Code.

DosInsertMessage returns one of the following values:

• NO_ERROR 87
  ERROR_INVALID_PARAMETER
  316
  ERROR_MR_MSG_TOO_LONG
  320
  ERROR_MR_INV_IVCOUNT
  For a full list of error codes, see Errors.

---

[Back: DosInsertMessage Return Value - ulrc]
[Next: DosInsertMessage - Remarks]