hlink.idl File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
interface	IHlink
interface	IHlinkSite
interface	IEnumHLITEM
struct	IEnumHLITEM::tagHLITEM
interface	IHlinkBrowseContext
struct	IHlinkBrowseContext::_tagHLTBINFO
struct	IHlinkBrowseContext::_tagHLBWINFO
interface	IHlinkTarget
interface	IHlinkFrame
interface	IExtensionServices

Typedefs
typedef enum _HLSR_NOREDEF10	HLSR

Enumerations
enum	_HLSR_NOREDEF10 { HLSR_HOME , HLSR_SEARCHPAGE , HLSR_HISTORYFOLDER }

Functions
HRESULT WINAPI	HlinkCreateFromMoniker (IMoniker *, LPCWSTR, LPCWSTR, IHlinkSite *, DWORD, IUnknown *, REFIID, void **)
HRESULT WINAPI	HlinkCreateFromString (LPCWSTR, LPCWSTR, LPCWSTR, IHlinkSite *, DWORD, IUnknown *, REFIID, void **)
HRESULT WINAPI	HlinkCreateFromData (IDataObject *, IHlinkSite *, DWORD dwSiteData, IUnknown *, REFIID, void **)
HRESULT WINAPI	HlinkCreateExtensionServices (LPCWSTR, HWND, LPCWSTR, LPCWSTR, IUnknown *, REFIID, void **)
HRESULT WINAPI	HlinkQueryCreateFromData (IDataObject *)
HRESULT WINAPI	HlinkClone (IHlink *, REFIID, IHlinkSite *, DWORD, void **)
HRESULT WINAPI	HlinkCreateBrowseContext (IUnknown *, REFIID, void **)
HRESULT WINAPI	HlinkNavigateToStringReference (LPCWSTR, LPCWSTR, IHlinkSite *, DWORD, IHlinkFrame *, DWORD, LPBC, IBindStatusCallback *, IHlinkBrowseContext *)
HRESULT WINAPI	HlinkNavigate (IHlink *, IHlinkFrame *, DWORD, LPBC, IBindStatusCallback *, IHlinkBrowseContext *)
HRESULT WINAPI	HlinkOnNavigate (IHlinkFrame *, IHlinkBrowseContext *, DWORD, IMoniker *, LPCWSTR, LPCWSTR, ULONG *)
HRESULT WINAPI	HlinkIsShortcut (LPCWSTR)
HRESULT WINAPI	HlinkTranslateURL (LPCWSTR, DWORD, LPWSTR *)
HRESULT WINAPI	HlinkParseDisplayName (LPBC, LPCWSTR, BOOL, ULONG *, IMoniker **)
HRESULT WINAPI	HlinkResolveMonikerForData (LPMONIKER, DWORD, LPBC, ULONG, FORMATETC *, IBindStatusCallback *, LPMONIKER)
HRESULT WINAPI	HlinkUpdateStackItem (IHlinkFrame *, IHlinkBrowseContext *, ULONG, IMoniker *, LPCWSTR, LPCWSTR)
HRESULT WINAPI	HlinkSetSpecialReference (ULONG uReference, LPCWSTR pwzReference)
HRESULT WINAPI	HlinkGetSpecialReference (ULONG uReference, LPWSTR *ppwzReference)

Typedef Documentation

HLSR

typedef enum _HLSR_NOREDEF10 HLSR

Enumeration Type Documentation

_HLSR_NOREDEF10

enum _HLSR_NOREDEF10

Enumerator
HLSR_HOME
HLSR_SEARCHPAGE
HLSR_HISTORYFOLDER

Definition at line 42 of file hlink.idl.

                             {
    HLSR_HOME,
    HLSR_SEARCHPAGE,
    HLSR_HISTORYFOLDER
} HLSR;

Function Documentation

HlinkClone()

HRESULT WINAPI HlinkClone	(	IHlink *	hlink,
		REFIID	riid,
		IHlinkSite *	hls,
		DWORD	site_data,
		void **	obj
	)

Definition at line 421 of file hlink_main.c.

{
    IMoniker *mk, *clone_mk = NULL;
    WCHAR *loc, *name = NULL;
    HRESULT hres;
 
    if(!hlink || !riid || !obj)
        return E_INVALIDARG;
 
    *obj = NULL;
 
    hres = IHlink_GetMonikerReference(hlink, HLINKGETREF_DEFAULT, &mk, &loc);
    if(FAILED(hres))
        return hres;
 
    if(mk) {
        IStream *strm;
        LARGE_INTEGER lgint;
 
        hres = CreateStreamOnHGlobal(NULL, TRUE, &strm);
        if(FAILED(hres)) {
            IMoniker_Release(mk);
            goto cleanup;
        }
 
        hres = OleSaveToStream((IPersistStream*)mk, strm);
        if(FAILED(hres)) {
            IStream_Release(strm);
            IMoniker_Release(mk);
            goto cleanup;
        }
        IMoniker_Release(mk);
 
        lgint.QuadPart = 0;
        hres = IStream_Seek(strm, lgint, STREAM_SEEK_SET, NULL);
        if(FAILED(hres)) {
            IStream_Release(strm);
            goto cleanup;
        }
 
        hres = OleLoadFromStream(strm, &IID_IMoniker, (void**)&clone_mk);
        IStream_Release(strm);
        if(FAILED(hres))
            goto cleanup;
    }
 
    hres = IHlink_GetFriendlyName(hlink, HLFNAMEF_DEFAULT, &name);
    if(FAILED(hres))
        goto cleanup;
 
    hres = HlinkCreateFromMoniker(clone_mk, loc, name, hls, site_data, NULL,
            &IID_IHlink, obj);
 
cleanup:
    if(clone_mk)
        IMoniker_Release(clone_mk);
    CoTaskMemFree(loc);
    CoTaskMemFree(name);
    return hres;
}

Referenced by test_HlinkClone().

HlinkCreateBrowseContext()

HRESULT WINAPI HlinkCreateBrowseContext	(	IUnknown *	piunkOuter,
		REFIID	riid,
		void **	ppvObj
	)

Definition at line 150 of file hlink_main.c.

{
    TRACE("%p %s %p\n", piunkOuter, debugstr_guid(riid), ppvObj);
    return CoCreateInstance(&CLSID_StdHlinkBrowseContext, piunkOuter, CLSCTX_INPROC_SERVER, riid, ppvObj);
}

Referenced by test_BrowseWindowInfo(), test_GetObject(), test_interfaces(), and test_SetInitialHlink().

HlinkCreateExtensionServices()

HRESULT WINAPI HlinkCreateExtensionServices	(	LPCWSTR	pwzAdditionalHeaders,
		HWND	phwnd,
		LPCWSTR	pszUsername,
		LPCWSTR	pszPassword,
		IUnknown *	punkOuter,
		REFIID	riid,
		void **	ppv
	)

Definition at line 299 of file extserv.c.

{
    ExtensionService *ret;
    HRESULT hres = S_OK;
 
    TRACE("%s %p %s %s %p %s %p\n",debugstr_w(pwzAdditionalHeaders),
            phwnd, debugstr_w(pszUsername), debugstr_w(pszPassword),
            punkOuter, debugstr_guid(riid), ppv);
 
    if (!(ret = calloc(1, sizeof(*ret))))
        return E_OUTOFMEMORY;
 
    ret->IUnknown_inner.lpVtbl = &ExtServUnkVtbl;
    ret->IAuthenticate_iface.lpVtbl = &AuthenticateVtbl;
    ret->IHttpNegotiate_iface.lpVtbl = &HttpNegotiateVtbl;
    ret->IExtensionServices_iface.lpVtbl = &ExtServVtbl;
    ret->ref = 1;
 
    ExtServ_ImplSetAuthenticateData(ret, phwnd, pszUsername, pszPassword);
    ExtServ_ImplSetAdditionalHeaders(ret, pwzAdditionalHeaders);
 
    if(!punkOuter) {
        ret->outer_unk = &ret->IUnknown_inner;
        hres = IUnknown_QueryInterface(&ret->IUnknown_inner, riid, ppv);
        IUnknown_Release(&ret->IUnknown_inner);
    }else if(IsEqualGUID(&IID_IUnknown, riid)) {
        ret->outer_unk = punkOuter;
        *ppv = &ret->IUnknown_inner;
    }else {
        IUnknown_Release(&ret->IUnknown_inner);
        hres = E_INVALIDARG;
    }
 
    return hres;
}

Referenced by test_HlinkCreateExtensionServices().

HlinkCreateFromData()

HRESULT WINAPI HlinkCreateFromData	(	IDataObject *	piDataObj,
		IHlinkSite *	pihlsite,
		DWORD	dwSiteData,
		IUnknown *	piunkOuter,
		REFIID	riid,
		void **	ppvObj
	)

Definition at line 200 of file hlink_main.c.

{
    FIXME("%p, %p, %ld, %p, %s, %p\n", piDataObj, pihlsite, dwSiteData,
           piunkOuter, debugstr_guid(riid), ppvObj);
    *ppvObj = NULL;
    return E_NOTIMPL;
}

HlinkCreateFromMoniker()

HRESULT WINAPI HlinkCreateFromMoniker	(	IMoniker *	pimkTrgt,
		LPCWSTR	pwzLocation,
		LPCWSTR	pwzFriendlyName,
		IHlinkSite *	pihlsite,
		DWORD	dwSiteData,
		IUnknown *	piunkOuter,
		REFIID	riid,
		void **	ppvObj
	)

Definition at line 47 of file hlink_main.c.

{
    IHlink *hl = NULL;
    HRESULT hr;
 
    TRACE("%p %s %s %p %li %p %s %p\n", pimkTrgt, debugstr_w(pwzLocation),
            debugstr_w(pwzFriendlyName), pihlsite, dwSiteData, piunkOuter,
            debugstr_guid(riid), ppvObj);
 
    hr = CoCreateInstance(&CLSID_StdHlink, piunkOuter, CLSCTX_INPROC_SERVER, &IID_IHlink, (LPVOID*)&hl);
    if (FAILED(hr))
        return hr;
 
    IHlink_SetMonikerReference(hl, HLINKSETF_LOCATION | HLINKSETF_TARGET, pimkTrgt, pwzLocation);
 
    if (pwzFriendlyName)
        IHlink_SetFriendlyName(hl, pwzFriendlyName);
    if (pihlsite)
        IHlink_SetHlinkSite(hl, pihlsite, dwSiteData);
 
    hr = IHlink_QueryInterface(hl, riid, ppvObj);
    IHlink_Release(hl);
 
    return hr;
}

Referenced by HlinkClone(), IHlinkBC_SetInitialHlink(), IHlinkBC_UpdateHlink(), test_Hlink_Navigate(), test_HlinkClone(), test_HlinkCreateFromMoniker(), test_HlinkGetSetMonikerReference(), test_HlinkGetSetStringReference(), and test_HlinkSite().

HlinkCreateFromString()

HRESULT WINAPI HlinkCreateFromString	(	LPCWSTR	pwzTarget,
		LPCWSTR	pwzLocation,
		LPCWSTR	pwzFriendlyName,
		IHlinkSite *	pihlsite,
		DWORD	dwSiteData,
		IUnknown *	piunkOuter,
		REFIID	riid,
		void **	ppvObj
	)

Definition at line 78 of file hlink_main.c.

{
    IHlink *hl = NULL;
    HRESULT hr;
    WCHAR *hash, *tgt;
    const WCHAR *loc;
 
    TRACE("%s %s %s %p %li %p %s %p\n", debugstr_w(pwzTarget),
            debugstr_w(pwzLocation), debugstr_w(pwzFriendlyName), pihlsite,
            dwSiteData, piunkOuter, debugstr_guid(riid), ppvObj);
 
    hr = CoCreateInstance(&CLSID_StdHlink, piunkOuter, CLSCTX_INPROC_SERVER, &IID_IHlink, (void **)&hl);
    if (FAILED(hr))
        return hr;
 
    if (pwzTarget)
    {
        hash = wcschr(pwzTarget, '#');
        if (hash)
        {
            if (hash == pwzTarget)
                tgt = NULL;
            else
            {
                int tgt_len = hash - pwzTarget;
                tgt = malloc((tgt_len + 1) * sizeof(WCHAR));
                if (!tgt)
                    return E_OUTOFMEMORY;
                memcpy(tgt, pwzTarget, tgt_len * sizeof(WCHAR));
                tgt[tgt_len] = 0;
            }
            if (!pwzLocation)
                loc = hash + 1;
            else
                loc = pwzLocation;
        }
        else
        {
            tgt = wcsdup(pwzTarget);
            if (!tgt)
                return E_OUTOFMEMORY;
            loc = pwzLocation;
        }
    }
    else
    {
        tgt = NULL;
        loc = pwzLocation;
    }
 
    IHlink_SetStringReference(hl, HLINKSETF_TARGET | HLINKSETF_LOCATION, tgt, loc);
 
    free(tgt);
 
    if (pwzFriendlyName)
        IHlink_SetFriendlyName(hl, pwzFriendlyName);
 
    if (pihlsite)
        IHlink_SetHlinkSite(hl, pihlsite, dwSiteData);
 
    hr = IHlink_QueryInterface(hl, riid, ppvObj);
    IHlink_Release(hl);
 
    return hr;
}

Referenced by HlinkNavigateToStringReference(), test_HashLink(), test_HlinkClone(), test_HlinkCreateFromString(), test_HlinkMoniker(), test_HlinkSite(), test_persist(), and test_reference().

HlinkGetSpecialReference()

HRESULT WINAPI HlinkGetSpecialReference	(	ULONG	uReference,
		LPWSTR *	ppwzReference
	)

Definition at line 266 of file hlink_main.c.

{
    DWORD res, type, size = 100;
    LPCWSTR value_name;
    WCHAR *buf;
    HKEY hkey;
 
    TRACE("(%lu %p)\n", uReference, ppwzReference);
 
    *ppwzReference = NULL;
 
    switch(uReference) {
    case HLSR_HOME:
        value_name = L"Start Page";
        break;
    case HLSR_SEARCHPAGE:
        value_name = L"Search Page";
        break;
    case HLSR_HISTORYFOLDER:
        return E_NOTIMPL;
    default:
        return E_INVALIDARG;
    }
 
    res = RegOpenKeyW(HKEY_CURRENT_USER, L"Software\\Microsoft\\Internet Explorer\\Main", &hkey);
    if(res != ERROR_SUCCESS) {
        WARN("Could not open key: %lu\n", res);
        return HRESULT_FROM_WIN32(res);
    }
 
    buf = CoTaskMemAlloc(size);
    res = RegQueryValueExW(hkey, value_name, NULL, &type, (PBYTE)buf, &size);
    buf = CoTaskMemRealloc(buf, size);
    if(res == ERROR_MORE_DATA)
        res = RegQueryValueExW(hkey, value_name, NULL, &type, (PBYTE)buf, &size);
    RegCloseKey(hkey);
    if(res != ERROR_SUCCESS) {
        WARN("Could not query value %s: %lu\n", debugstr_w(value_name), res);
        CoTaskMemFree(buf);
        return HRESULT_FROM_WIN32(res);
    }
 
    *ppwzReference = buf;
    return S_OK;
}

Referenced by test_special_reference().

HlinkIsShortcut()

HRESULT WINAPI HlinkIsShortcut

(

LPCWSTR

pwzFileName

)

Definition at line 247 of file hlink_main.c.

{
    int len;
 
    TRACE("(%s)\n", debugstr_w(pwzFileName));
 
    if(!pwzFileName)
        return E_INVALIDARG;
 
    len = lstrlenW(pwzFileName)-4;
    if(len < 0)
        return S_FALSE;
 
    return wcsicmp(pwzFileName+len, L".url") ? S_FALSE : S_OK;
}

Referenced by test_HlinkIsShortcut().

HlinkNavigate()

HRESULT WINAPI HlinkNavigate	(	IHlink *	phl,
		IHlinkFrame *	phlFrame,
		DWORD	grfHLNF,
		LPBC	pbc,
		IBindStatusCallback *	pbsc,
		IHlinkBrowseContext *	phlbc
	)

Definition at line 159 of file hlink_main.c.

{
    HRESULT r = S_OK;
 
    TRACE("%p %p %li %p %p %p\n", phl, phlFrame, grfHLNF, pbc, pbsc, phlbc);
 
    if (phlFrame)
        r = IHlinkFrame_Navigate(phlFrame, grfHLNF, pbc, pbsc, phl);
    else if (phl)
        r = IHlink_Navigate(phl, grfHLNF, pbc, pbsc, phlbc);
 
    return r;
}

Referenced by HlinkNavigateToStringReference().

HlinkNavigateToStringReference()

HRESULT WINAPI HlinkNavigateToStringReference	(	LPCWSTR	pwzTarget,
		LPCWSTR	pwzLocation,
		IHlinkSite *	pihlsite,
		DWORD	dwSiteData,
		IHlinkFrame *	pihlframe,
		DWORD	grfHLNF,
		LPBC	pibc,
		IBindStatusCallback *	pibsc,
		IHlinkBrowseContext *	pihlbc
	)

Definition at line 222 of file hlink_main.c.

{
    HRESULT r;
    IHlink *hlink = NULL;
 
    TRACE("%s %s %p %08lx %p %08lx %p %p %p\n",
          debugstr_w(pwzTarget), debugstr_w(pwzLocation), pihlsite,
          dwSiteData, pihlframe, grfHLNF, pibc, pibsc, pihlbc);
 
    r = HlinkCreateFromString( pwzTarget, pwzLocation, NULL, pihlsite,
                               dwSiteData, NULL, &IID_IHlink, (LPVOID*) &hlink );
    if (SUCCEEDED(r)) {
        r = HlinkNavigate(hlink, pihlframe, grfHLNF, pibc, pibsc, pihlbc);
        IHlink_Release(hlink);
    }
 
    return r;
}

Referenced by test_Hlink_Navigate().

HlinkOnNavigate()

HRESULT WINAPI HlinkOnNavigate	(	IHlinkFrame *	phlFrame,
		IHlinkBrowseContext *	phlbc,
		DWORD	grfHLNF,
		IMoniker *	pmkTarget,
		LPCWSTR	pwzLocation,
		LPCWSTR	pwzFriendlyName,
		ULONG *	puHLID
	)

Definition at line 178 of file hlink_main.c.

{
    HRESULT r;
 
    TRACE("%p %p %li %p %s %s %p\n",phlFrame, phlbc, grfHLNF, pmkTarget,
            debugstr_w(pwzLocation), debugstr_w(pwzFriendlyName), puHLID);
 
    r = IHlinkBrowseContext_OnNavigateHlink(phlbc, grfHLNF, pmkTarget,
            pwzLocation, pwzFriendlyName, puHLID);
 
    if (phlFrame)
        r = IHlinkFrame_OnNavigate(phlFrame,grfHLNF,pmkTarget, pwzLocation,
                pwzFriendlyName, 0);
 
    return r;
}

HlinkParseDisplayName()

HRESULT WINAPI HlinkParseDisplayName	(	LPBC	pibc,
		LPCWSTR	pwzDisplayName,
		BOOL	fNoForceAbs,
		ULONG *	pcchEaten,
		IMoniker **	ppimk
	)

Definition at line 344 of file hlink_main.c.

{
    ULONG eaten = 0, len;
    HRESULT hres;
 
    TRACE("(%p %s %x %p %p)\n", pibc, debugstr_w(pwzDisplayName), fNoForceAbs, pcchEaten, ppimk);
 
    if(fNoForceAbs)
        FIXME("Unsupported fNoForceAbs\n");
 
    len = ARRAY_SIZE(L"file:") - 1;
    if(!wcsnicmp(pwzDisplayName, L"file:", len)) {
        pwzDisplayName += len;
        eaten += len;
 
        while(*pwzDisplayName == '/') {
            pwzDisplayName++;
            eaten++;
        }
    }else {
        hres = MkParseDisplayNameEx(pibc, pwzDisplayName, pcchEaten, ppimk);
        if(SUCCEEDED(hres))
            return hres;
 
        hres = MkParseDisplayName(pibc, pwzDisplayName, pcchEaten, ppimk);
        if(SUCCEEDED(hres))
            return hres;
    }
 
    hres = CreateFileMoniker(pwzDisplayName, ppimk);
    if(SUCCEEDED(hres))
        *pcchEaten = eaten + lstrlenW(pwzDisplayName);
 
    return hres;
}

Referenced by test_HlinkParseDisplayName().

HlinkQueryCreateFromData()

HRESULT WINAPI HlinkQueryCreateFromData

(

IDataObject *

piDataObj

)

Definition at line 213 of file hlink_main.c.

{
    FIXME("%p\n", piDataObj);
    return E_NOTIMPL;
}

HlinkResolveMonikerForData()

HRESULT WINAPI HlinkResolveMonikerForData	(	LPMONIKER	pimkReference,
		DWORD	reserved,
		LPBC	pibc,
		ULONG	cFmtetc,
		FORMATETC *	rgFmtetc,
		IBindStatusCallback *	pibsc,
		LPMONIKER	pimkBase
	)

Definition at line 384 of file hlink_main.c.

{
    LPOLESTR name = NULL;
    IBindCtx *bctx;
    DWORD mksys = 0;
    void *obj = NULL;
    HRESULT hres;
 
    TRACE("(%p %lx %p %ld %p %p %p)\n", pimkReference, reserved, pibc, cFmtetc, rgFmtetc, pibsc, pimkBase);
 
    if(cFmtetc || rgFmtetc || pimkBase)
        FIXME("Unsupported args\n");
 
    hres = RegisterBindStatusCallback(pibc, pibsc, NULL /* FIXME */, 0);
    if(FAILED(hres))
        return hres;
 
    hres = IMoniker_IsSystemMoniker(pimkReference, &mksys);
    if(SUCCEEDED(hres) && mksys != MKSYS_URLMONIKER)
        WARN("sysmk = %lx\n", mksys);
 
    /* FIXME: What is it for? */
    CreateBindCtx(0, &bctx);
    hres = IMoniker_GetDisplayName(pimkReference, bctx, NULL, &name);
    IBindCtx_Release(bctx);
    if(SUCCEEDED(hres)) {
        TRACE("got display name %s\n", debugstr_w(name));
        CoTaskMemFree(name);
    }
 
    return IMoniker_BindToStorage(pimkReference, pibc, NULL, &IID_IUnknown, &obj);
}

Referenced by test_HlinkResolveMonikerForData().

HlinkSetSpecialReference()

HRESULT WINAPI HlinkSetSpecialReference	(	ULONG	uReference,
		LPCWSTR	pwzReference
	)

HlinkTranslateURL()

HRESULT WINAPI HlinkTranslateURL	(	LPCWSTR	pwzURL,
		DWORD	grfFlags,
		LPWSTR *	ppwzTranslatedURL
	)

Definition at line 315 of file hlink_main.c.

{
    FIXME("(%s %08lx %p)\n", debugstr_w(pwzURL), grfFlags, ppwzTranslatedURL);
    return E_NOTIMPL;
}

HlinkUpdateStackItem()

HRESULT WINAPI HlinkUpdateStackItem	(	IHlinkFrame *	frame,
		IHlinkBrowseContext *	bc,
		ULONG	hlid,
		IMoniker *	target,
		LPCWSTR	location,
		LPCWSTR	friendly_name
	)

Definition at line 324 of file hlink_main.c.

{
    HRESULT hr;
 
    TRACE("(%p %p 0x%lx %p %s %s)\n", frame, bc, hlid, target, debugstr_w(location), debugstr_w(friendly_name));
 
    if (!frame && !bc) return E_INVALIDARG;
 
    if (frame)
        hr = IHlinkFrame_UpdateHlink(frame, hlid, target, location, friendly_name);
    else
        hr = IHlinkBrowseContext_UpdateHlink(bc, hlid, target, location, friendly_name);
 
    return hr;
}

Referenced by test_HlinkUpdateStackItem().