# OLECALPOLESTR type
{: .no_toc }

A counted array of pointers to Unicode strings, with the layout of the Windows `CALPOLESTR` structure.

**OLECALPOLESTR** is a user-defined type declared in the package's `OLEGuids` module, so both `OLECALPOLESTR` and `OLEGuids.OLECALPOLESTR` name it. It mirrors the Windows structure [CALPOLESTR](https://learn.microsoft.com/en-us/windows/win32/api/ocidl/ns-ocidl-calpolestr), which holds the number of elements of an array and the address of the array.

```tb inert=signature
Public Type OLECALPOLESTR
    cElems As Long
    pElems As LongPtr
End Type
```

## Fields

*cElems*
: A **Long** holding the number of elements in the array.

*pElems*
: A **LongPtr** holding the address of the array. Each element is a pointer to a null-terminated Unicode string.

## Where it is used

[**IPerPropertyBrowsing.GetPredefinedStrings**](/tB/Packages/Contributed/OLEGuids/IPerPropertyBrowsing.md#getpredefinedstrings) takes it by reference as *pCaStringsOut* and fills it with the names of the values a property can take. The object allocates the array and each string, and the caller frees them with `CoTaskMemFree`.

## See Also

- [OLECADWORD](/tB/Packages/Contributed/OLEGuids/OLECADWORD.md) type -- a counted array of **DWORD** values
- [OLECAUUID](/tB/Packages/Contributed/OLEGuids/OLECAUUID.md) type -- a counted array of GUIDs
- [IPerPropertyBrowsing](/tB/Packages/Contributed/OLEGuids/IPerPropertyBrowsing.md) interface -- display strings, property pages and predefined values of an object's properties
