DosGetNamedSharedMem - Parameters

ppb (PPVOID) - output

A pointer to a variable that will receive the base address of the shared memory object.

pszName (PSZ) - input

The address of the name string associated with the shared memory object.

The name is an ASCIIZ string in the format of an OS/2 file name, and is in the subdirectory \SHARMEM\, for example, \SHAREMEM\PUBLIC.DAT.

flag (ULONG) - input

A set of attribute flags that specify the desired access protection for the shared memory object.

Desired Access Protection

The following access protections are available:

• PAG_READ Read access

• PAG_WRITE
  Write access

• PAG_EXECUTE
  Execute access to the committed pages in the shared memory object.

• PAG_GUARD
  Access to the committed pages in the shared memory object causes a "guard page entered" condition to be raised in the subject process.

  At least one of the bits PAG_READ, PAG_WRITE, or PAG_EXECUTE must be specified.

ulrc (APIRET) - returns

Return Code.

DosGetNamedSharedMem returns one of the following values:

• NO_ERROR 2
  ERROR_FILE_NOT_FOUND
  8
  ERROR_NOT_ENOUGH_MEMORY
  31
  ERROR_GEN_FAILURE
  87
  ERROR_INVALID_PARAMETER
  95
  ERROR_INTERRUPT
  123
  ERROR_INVALID_NAME
  212
  ERROR_LOCKED
  For a full list of error codes, see Errors.

---

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