DosGetMessage - Parameters

pTable (PCHAR *) - input

Pointer table.

Each doubleword pointer points 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

Number of variable insertion text strings.

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

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.

msgnumber (ULONG) - input

The message number requested.

pszFile (PSZ) - input

The drive designation, path, and name of the file where the message can be found.

The drive designation and path are optional. This specifies a file that was previously prepared by the MKMSGF utility program.

pcbMsg (PULONG) - output

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

ulrc (APIRET) - returns

Return Code.

DosGetMessage returns one of the following values:

• NO_ERROR 2
  ERROR_FILE_NOT_FOUND
  37
  ERROR_CODE_PAGE_MISMATCHED
  87
  ERROR_INVALID_PARAMETER
  206
  ERROR_FILENAME_EXCED_RANGE
  316
  ERROR_MR_MSG_TOO_LONG
  317
  ERROR_MR_MID_NOT_FOUND
  318
  ERROR_MR_UN_ACC_MSGF
  319
  ERROR_MR_INV_MSGF_FORMAT
  320
  ERROR_MR_INV_IVCOUNT
  321
  ERROR_MR_UN_PERFORM
  For a full list of error codes, see Errors.

---

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