ShFileOperation - hNameMappings

From: AlanGLLoyd (alanglloyd_at_aol.com)
Date: 09/23/04


Date: 23 Sep 2004 07:42:28 GMT

In an ShFileOperation API call, an SHFILEOPSTRUCT (TShFileOpStruct) is
referenced. When FOF_WANTMAPPINGHANDLE is specified in the fFlags element this
requires a hNameMappings element.

hNameMappings is declared as a handle in MSDN, but as a pointer in Delphi. This
handle is said to require freeing by SHFreeNameMappings using the handle. It is
described as a memory structure of Count : integer + count of TShNameMapping
records.

How does one get the handle to it, assuming it is not just a pointer to the
name mapping structure asembly. Or is it just such a pointer.

If it is a pointer do I have to free the memory _I_ have allocated to that
name-mapping structure, or does calling SHFreeNameMappings do that for me ?

Any suggestions thankfully received.

Alan Lloyd
alanglloyd@aol.com