---
name: "CreateFileMappingA"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/CreateFileMappingA"
---

# CreateFileMappingA(3w)

## NAME

**CreateFileMappingA** (KERNEL32.@)

## SYNOPSIS

HANDLE CreateFileMappingA\
  (\
   HANDLE               *hFile*,\
   SECURITY\_ATTRIBUTES\* *sa*,\
   DWORD                *protect*,\
   DWORD                *size\_high*,\
   DWORD                *size\_low*,\
   LPCSTR               *name*\
  )

## DESCRIPTION

Creates a named or unnamed file-mapping object for the specified file.

## PARAMS

*hFile* **\[In\]**  Handle to the file to map.

*sa* **\[In\]**  Optional security attributes.

*protect* **\[In\]**  Protection for mapping object.

*size\_high* **\[In\]**  High-order **32** bits of object size.

*size\_low* **\[In\]**  Low-order **32** bits of object size.

*name* **\[In\]**  Name of file-mapping object.

## RETURNS

**Success:** Handle.

**Failure:** **NULL**. Mapping object does not exist.

## IMPLEMENTATION

Declared in **"winbase.h"**.

Implemented in **"dlls/kernel32/virtual.c"**.