ESMCopy

Copies a specified number of bytes.

Library:LibC
Classification:NetWare OS
Service:NetWare Platform

Syntax

  #include <esm.h> 
   
  int ESMCopy (
     addr64_t   source,
     addr64_t   destination,
     size64_t   length);

Parameters

source

(IN) Specifies the source address.

destination

(IN) Specifies the destination address.

length

(IN) Specifies the number of bytes.

Return Values

If successful, returns 0. Otherwise, returns a nonzero error code.

Decimal

Name

Description

5

ERR_INVAL_ADDRESS

The specified address is out of the range of memory allocated.

6

INVALID_SRC_ADDRESS

The source address is not valid.

7

INVALID_DEST_ADDRESS

The destination address is not valid.

8

SRC_DEST_OVERLAP

The source and destination buffers overlap.

For other possible values, see Section 30.3, Return Values for ESM Functions.

Remarks

The ESMCopy function copies the number of bytes specified by length from the source address to the destination address. The addresses can specify normal memory addresses below 4 GB or extended addresses above 4 GB.

The source area can overlap the destination area, but overlapping source and destination buffers is not allowed.

See Also