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

# SafeArrayCreate(3w)

## NAME

**SafeArrayCreate** (OLEAUT32.15)

## SYNOPSIS

SAFEARRAY\* SafeArrayCreate\
  (\
   VARTYPE         *vt*,\
   UINT            *cDims*,\
   SAFEARRAYBOUND\* *rgsabound*\
  )

## DESCRIPTION

Create a new SafeArray.

## PARAMS

*vt* **\[In\]**  Type to store in the safe array.

*cDims* **\[In\]**  Number of array dimensions.

*rgsabound* **\[In\]**  Bounds of the array dimensions.

## RETURNS

**Success:** A pointer to a new array object.

**Failure:** **NULL**, if any parameter is invalid or memory allocation fails.

## NOTES

Win32 allows arrays with **0** sized dimensions. This bug is not reproduced in the Wine implementation. See **[SafeArray(3w)](/SafeArray/3w.md)**.

## IMPLEMENTATION

Declared in **"oleauto.h"**.

Implemented in **"dlls/oleaut32/safearray.c"**.

Debug channel **"variant"**.