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

# SHAddDataBlock(3w)

## NAME

**SHAddDataBlock** (SHLWAPI.20)

## SYNOPSIS

HRESULT SHAddDataBlock\
  (\
   LPDBLIST\*               *lppList*,\
   const DATABLOCK\_HEADER\* *lpNewItem*\
  )

## DESCRIPTION

Insert a new item into a DataBlock list.

## PARAMS

*lppList* **\[0\]**  Pointer to the List

*lpNewItem* **\[In\]**  The new item to add to the list.

## RETURNS

**Success:** **S\_OK**. The item is added to the list.

**Failure:** An **HRESULT** error code.

## NOTES

If the size of the element to be inserted is less than the size of a **DATABLOCK\_HEADER** node, or the Id for the item is **CLIST\_ID\_CONTAINER**, the call returns **S\_OK** but does not actually add the element. See **[SHWriteDataBlockList(3w)](/SHWriteDataBlockList/3w.md)**.

## IMPLEMENTATION

Exported by ordinal only. Use **[GetProcAddress(3w)](/GetProcAddress/3w.md)** to obtain a pointer to the function.

Implemented in **"dlls/shlwapi/clist.c"**.

Debug channel **"shell"**.