GetDestNameA

Annotations and hotspot links, Destinations and actions

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to GetDestName and string arguments are interpreted using the current SetAnsiMode code page

Returns the name of a named destination handle or an explicit destination array that is stored in the document name tree

Syntax

Delphi

Function DLGetDestNameA(InstanceID, DestID: Integer): PAnsiChar;

DLL

const char * DLGetDestNameA(int InstanceID, int DestID);

Parameters

DestID	Destination handle returned by APIs such as GetActionDest, GetOpenActionDestination or GetNamedDestination

Return values

empty string	The handle is not a named destination and no matching name-tree entry was found
name	The destination name

Remarks

For explicit destination arrays, the function searches the document name tree and returns the matching destination name when one exists