This documentation is archived and is not being maintained.


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 return a handle for data saved by the xlDefineBinaryName function. 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(xlGetBinaryName, LPXLOPER12 pxRes, 1, LPXLOPER12 pxName);

pxRes (xltypeBigData or xltypeErr)

Bigdata structure specifying the retrieved data or an error is the data could not be retrieved or the name is not defined. When the function returns, the hdata member of the XLOPER/XLOPER12 contains a handle for the named data. pxRes should be freed in a call to xlFree when no longer required.

pxName (xltypeStr)

A string specifying the name of the data.

Microsoft Office Excel owns the memory handle returned in hdata. In Windows, the handle is a global memory handle (allocated by the GlobalAlloc function).