xlDefineBinaryName

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Used to allocate persistent storage for an xltypeBigDataXLOPER/XLOPER12. Data with a defined binary name is saved with the workbook, and can be accessed by name at any time. For more information, see "Binary Name Scope Limitation" in Known Issues in Excel XLL Development.

Excel12(xlDefineBinaryName, 0, 2, LPXLOPER12 pxName, LPXLOPER12 pxData);

Parameters

pxName (xltypeStr)

A string specifying the name of the data. The string is subject to the same naming restrictions as defined names.

pxData (xltypeBigData)

Bigdata structure specifying the data to be stored. When you call this function, the lpbData member of the bigdata structure should point to the data for which the name is being defined, and the cbData member should contain the length of the data in bytes.

If the pxData argument is not specified (xltypeMissing), the named allocation specified by pxName is deleted.

See Also

Reference

xlGetBinaryName

Concepts

C API Functions That Can Be Called Only from a DLL or XLL

Known Issues in Excel XLL Development