Contents Previous Page Next Page
IHlinkTarget::GetFriendlyName

Retrieves a friendly name for the given hyperlink destination within this target.

HRESULT GetFriendlyName(

    LPCWSTR 
szLocation,                // Hyperlink location within this target     
                                                                                    
    LPWSTR * pszFriendlyName           // Buffer to receive the friendly name       
                                                                                    
   );                                                                               
                                                                                    

Parameters

szLocation

[in, unique] String that indicates the position of the hyperlink destination within this hyperlink target.

pszFriendlyName

[out] Pointer to the buffer to return the friendly name. This string must be allocated using CoTaskMemAlloc. It is the callerÆs responsibility to free this string using CoTaskMemFree.

Return Values

S_OK

The friendly name string of the hyperlink destination with this target has been retrieved.

E_OUTOFMEMORY

Indicates there is insufficient memory to retrieve the friendly name.

See Also

IHlink::GetFriendlyName