URL Monikers Functions

Functions

AsyncInstallDistributionUnit

CoGetClassObjectFromURL

CoInternetCombineIUri

CoInternetCombineUrl

CoInternetCombineUrlEx

CoInternetCompareUrl

CoInternetGetSecurityUrlEx

CoInternetParseIUri

CoInternetQueryInfo

CompatFlagsFromClsid

CopyBindInfo

CopyStgMedium

CreateAsyncBindCtx

CreateAsyncBindCtxEx

CreateFormatEnumerator

CreateUri

CreateURLBinding (not currently implemented)

CreteURLMoniker

CreateURLMonikerEx

CreateURLMonikerEx2

FindMediaType

FindMediaTypeClass

FindMimeFromData

GetClassFileOrMime

GetClassURL (not currently implemented)

IsAsyncMoniker

IsValidURL

MkParseDisplayNameEx

ObtainUserAgentString

RegisterBindStatusCallback

RegisterFormatEnumerator

RegisterMediaTypeClass

RegisterMediaTypes

ReleaseBindInfo

RevokeBindStatusCallback

RevokeFormatEnumerator

URLDownloadToCacheFile

URLDownloadToFile

UrlMkGetSessionOption

UrlMkSetSessionOption

URLOpenBlockingStream

URLOpenPullStream

URLOpenStream

AsyncInstallDistributionUnit

Installs the specified component.

DECLARE FUNCTION AsyncInstallDistributionUnit _

   LIB "URLMON.DLL"  _

   ALIAS "AsyncInstallDistributionUnit" ( _
   BYVAL szDistUnit AS DWORD _
 , BYVAL szType AS DWORD _
 , BYVAL szExt AS DWORD _
 , BYVAL dwFileVersionMS AS DWORD _
 , BYVAL dwFileVersionLS AS DWORD _
 , BYVAL szURL AS DWORD _
 , BYVAL pbc AS DWORD _
 , BYVAL pvReserved AS DWORD _
 , BYVAL flags AS DWORD _
   ) AS LONG
 

CoGetClassObjectFromURL

Returns a factory object for a given CLSID.

DECLARE FUNCTION CoGetClassObjectFromURL _

   LIB "URLMON.DLL" _

   ALIAS "CoGetClassObjectFromURL" ( _
   BYREF rclsid AS GUID _
 , BYVAL szCodeURL AS DWORD _
 , BYVAL dwFileVersionMS AS DWORD _
 , BYVAL dwFileVersionLS AS DWORD _
 , BYVAL szContentType AS DWORD _
 , BYVAL pBindCtx AS DWORD _
 , BYVAL dwClsContext AS DWORD _
 , BYVAL pvReserved AS DWORD _
 , BYREF riid AS GUID _
 , BYVAL ppv AS DWORD PTR _
   ) AS LONG
 

CoInternetCombineIUri

Note: This documentation is preliminary and is subject to change.

DECLARE FUNCTION CoInternetCombineIUri _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetCombineIUri" ( _
   BYVAL pBaseUri AS DWORD _
 , BYVAL pRelativeUri AS DWORD _
 , BYVAL dwCombineFlags AS DWORD _
 , BYVAL ppCombinedUri AS DWORD PTR _
 , BYVAL dwReserved AS DWORD _
  ) AS LONG
 

CoInternetCombineUrl

Combines a base and relative URL into a full URL.

DECLARE FUNCTION CoInternetCombineUrl _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetCombineUrl" ( _
   BYVAL pwzBaseUrl AS DWORD _
 , BYVAL pwzRelativeUrl AS DWORD _
 , BYVAL dwCombineFlags AS DWORD _
 , BYREF pwzResult AS ANY _
 , BYVAL cchResult AS DWORD _
 , BYREF pcchResult AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CoInternetCombineUrlEx

Note: This documentation is preliminary and is subject to change.

DECLARE FUNCTION CoInternetCombineUrlEx _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetCombineUrlEx" ( _
   BYVAL pwzBaseUri AS DWORD _
 , BYVAL pwzRelativeUrl AS DWORD _
 , BYVAL dwCombineFlags AS DWORD _
 , BYREF pwzResult AS ANY _
 , BYVAL cchResult AS DWORD _
 , BYREF pcchResult AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CoInternetCompareUrl

Combines a base and relative URL into a full URL.

DECLARE FUNCTION CoInternetCompareUrl _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetCompareUrl" ( _
   BYVAL pwzUrl1 AS DWORD _
 , BYVAL pwzUrl2 AS DWORD _
 , BYVAL dwCompareFlags AS DWORD _
   ) AS LONG
 

CoInternetGetSecurityUrlEx

Note: This documentation is preliminary and is subject to change.

DECLARE FUNCTION CoInternetGetSecurityUrlEx _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetGetSecurityUrlEx" ( _
   BYVAL pwzBaseUri AS DWORD _
 , BYVAL pwzRelativeUrl AS DWORD _
 , BYVAL dwCombineFlags AS DWORD _
 , BYREF pwzResult AS ANY _
 , BYVAL cchResult AS DWORD _
 , BYREF pcchResult AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CoInternetParseIUri

Note: This documentation is preliminary and is subject to change.

DECLARE FUNCTION CoInternetParseIUri _

   LIB "URLMON.DLL" _

   ALIAS "CoInternetParseIUri" ( _
   BYVAL pIUri AS DWORD _
 , BYVAL ParseAction AS LONG _
 , BYVAL dwFlags AS DWORD _

 , BYREF pwzResult AS ANY _

 , BYVAL cchResult AS DWORD _

 , BYREF pcchResult AS DWORD _

 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CoInternetQueryInfo

Retrieves information related to the specified URL.

DECLARE FUNCTION CoInternetQueryInfo _
   LIB "URLMON.DLL" _
   ALIAS "CoInternetQueryInfo" ( _
   BYVAL pwzUrl AS DWORD _
 , BYVAL QueryOption AS LONG _
 , BYVAL dwQueryFlags AS DWORD _
 , BYREF pvBuffer AS ANY _
 , BYVAL cbBuffer AS DWORD _
 , BYREF pcbBuffer AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CompareSecurityIds

Compares two security identifiers (SIDs) for equivalence.

DECLARE FUNCTION CompareSecurityIds _
   LIB "URLMON.DLL" _
   ALIAS "CompareSecurityIds" ( _
   BYVAL pbSecurityId1 AS BYTE PTR _
 , BYVAL dwLen1 AS DWORD _
 , BYVAL pbSecurityId2 AS BYTE PTR _
 , BYVAL dwLen2 AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

CompatFlagsFromClsid

Reads the Microsoft ActiveX Compatibility registry entries for the specified ActiveX control.

DECLARE FUNCTION CompatFlagsFromClsid _
   LIB "URLMON.DLL" _
   ALIAS "CompatFlagsFromClsid" ( _
   BYREF pclsid AS GUID _
 , BYREF pdwCompatFlags AS DWORD _
 , BYREF pdwMiscStatusFlags AS DWORD _
   ) AS LONG
 

CopyBindInfo

Copies the given BINDINFO structure.

DECLARE FUNCTION CopyBindInfo _
   LIB "URLMON.DLL" _
   ALIAS "CopyBindInfo" ( _
   BYREF pcbiSrc AS BINDINFO _
 , BYREF pcbiDest AS BINDINFO _
   ) AS LONG
 

CopyStgMedium

Copies the given STGMEDIUM structure.

DECLARE FUNCTION CopyStgMedium _
   LIB "URLMON.DLL" _
   ALIAS "CopyStgMedium" ( _
   BYREF pcstgmedSrc AS STGMEDIUM _
 , BYREF pstgmedDest AS STGMEDIUM _
   ) AS LONG
 

CreateAsyncBindCtx

Creates an asynchronous bind context for use with asynchronous monikers.

DECLARE FUNCTION CreateAsyncBindCtx_
   LIB "URLMON.DLL" _
   ALIAS "CreateAsyncBindCtx" ( _
   BYVAL dwReserved AS DWORD _
 , BYVAL pbsc AS DWORD _
 , BYVAL penumfmtetc AS DWORD _
 , BYVAL ppbc AS DWORD PTR _
   ) AS LONG
 

CreateAsyncBindCtxEx

Creates an asynchronous bind context for use with asynchronous monikers.

DECLARE FUNCTION CreateAsyncBindCtxEx_
   LIB "URLMON.DLL" _
   ALIAS "CreateAsyncBindCtxEx" ( _
   BYVAL pbc AS DWORD _
 , BYVAL dwOptions AS DWORD _
 , BYVAL pbscb AS DWORD _
 , BYVAL pEnum AS DWORD _
 , BYVAL ppbc AS DWORD PTR _
 , BYVAL reserved AS DWORD _
   ) AS LONG
 

CreateFormatEnumerator

Creates an object that implements IEnumFORMATETC over a static array of FORMATETC structures.

DECLARE FUNCTION CreateFormatEnumerator_
   LIB "URLMON.DLL" _
   ALIAS "CreateFormatEnumerator" ( _
   BYVAL cfmetc AS DWORD _
 , BYREF rgfmetc AS DWORD _
 , BYREF ppenumfmetc AS DWORD _
   ) AS LONG
 

CreateUri

Note: This documentation is preliminary and is subject to change.

Creates a new IUri instance, and initializes it from a Uniform Resource Identifier (URI) string. CreateUri also normalizes and validates the URI.

DECLARE FUNCTION CreateUri _

   LIB "URLMON.DLL" _

   ALIAS "CreateUri" ( _
   BYVAL pwzURI AS DWORD _

 , BYVAL dwFlags AS DWORD _
 , BYVAL dwReserved AS DWORD _
 , BYVAL ppURI AS DWORD PTR _
   ) AS LONG
 

CreateURLMoniker

Creates a URL moniker from either a full URL string or from a base context URL moniker and a partial URL string.

DECLARE FUNCTION CreateURLMoniker _
   LIB "URLMON.DLL" _
   ALIAS "CreateURLMoniker" ( _
   BYVAL pmkContext AS DWORD _
 , BYVAL szURL AS DWORD _
 , BYVAL ppmk AS DWORD PTR _
   ) AS LONG
 

CreateURLMonikerEx

Creates a URL moniker from either a full URL or from a base context URL moniker and a partial URL.

DECLARE FUNCTION CreateURLMonikerEx _
   LIB "URLMON.DLL" _
   ALIAS "CreateURLMonikerEx" ( _
   BYVAL pmkContext AS DWORD _
 , BYVAL szURL AS DWORD _
 , BYVAL ppmk AS DWORD PTR _
 , BYVAL dwFlags AS DWORD _
   ) AS LONG
 

CreateURLMonikerEx2

Note: This documentation is preliminary and is subject to change.

DECLARE FUNCTION CreateURLMonikerEx2 _
   LIB "URLMON.DLL" _
   ALIAS "CreateURLMonikerEx2" ( _
   BYVAL pmkContext AS DWORD _
 , BYVAL szURL AS DWORD _
 , BYREF ppmk AS DWORD _
 , BYVAL dwFlags AS DWORD _
   ) AS LONG
 

FindMediaType

Retrieves the 32-bit value assigned to the specified media type.

DECLARE FUNCTION FindMediaType _
   LIB "URLMON.DLL" _
   ALIAS "FindMediaType" ( _
   BYREF rgszTypes AS ASCIIZ _
 , BYREF rgcfTypes AS DWORD _
   ) AS LONG
 

FindMediaFromData

Determines the Multipurpose Internet Mail Extensions (MIME) type from the data provided.

DECLARE FUNCTION FindMediaFromData _
   LIB "URLMON.DLL" _
   ALIAS "FindMediaFromData" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pwzUrl AS DWORD _
 , BYREF pBuffer AS ANY _
 , BYVAL cbSize AS DWORD _
 , BYVAL pwzMimeProposed AS DWORD _
 , BYVAL dwMimeFlags AS DWORD _
 , BYREF ppwzMimeOut AS ANY _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

FindMediaTypeClass

Retrieves the CLSID for the specified media type.

DECLARE FUNCTION FindMediaTypeClass _
   LIB "URLMON.DLL" _
   ALIAS "FindMediaTypeClass" ( _
   BYVAL pbc AS DWORD _
 , BYREF szType AS ASCIIZ _
 , BYREF pclsID AS GUID _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

FindMediaTypeClass

Determines the MIME type from the data provided.

DECLARE FUNCTION FindMimeFromData _
   LIB "URLMON.DLL" _
   ALIAS "FindMimeFromData" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pwszUrl AS DWORD _
 , BYREF pBuffer AS ANY _
 , BYVAL cbSize AS DWORD _
 , BYVAL pwzMimeProposed AS DWORD _
 , BYVAL dwMimeFlags AS DWORD _
 , BYREF ppwzMimeOut AS DWORD _
 , BYVAL dwReserved AS DWORD _
   ) AS LONG
 

GetClassFileOrMime

Determines the Multipurpose Internet Mail Extensions (MIME) type from the data provided.

DECLARE FUNCTION GetClassFileOrMime _
   LIB "URLMON.DLL" _
   ALIAS "GetClassFileOrMime" ( _
   BYVAL pbc AS DWORD _
 , BYVAL szFileName AS DWORD _
 , BYREF pBuffer AS ANY _
 , BYVAL cbSize AS DWORD _
 , BYVAL szMime AS DWORD _
 , BYVAL dwReserved AS DWORD _
 , BYREF pclsid AS GUID _

   ) AS LONG
 

IsAsyncMoniker

Tests to determine whether a moniker supports asynchronous binding.

DECLARE FUNCTION IsAsyncMoniker _
   LIB "URLMON.DLL" _
   ALIAS "IsAsyncMoniker" ( _
   BYVAL pmk AS DWORD _
   ) AS LONG
 

IsValidUrl

Determines if a specified string is a valid URL.

DECLARE FUNCTION IsValidUrl _
   LIB "URLMON.DLL" _
   ALIAS "IsValidUrl" ( _
   BYVAL pbc AS DWORD _
 , BYVAL szURL AS DWORD _
 , BYVAL dwReserved AS DWORD _

   ) AS LONG
 

MkParseDisplayNameEx

Determines if a specified string is a valid URL.

DECLARE FUNCTION MkParseDisplayNameEx _
   LIB "URLMON.DLL" _
   ALIAS "MkParseDisplayNameEx" ( _
   BYVAL pbc AS DWORD _
 , BYVAL szDisplayName AS DWORD _
 , BYREF pcchEaten AS DWORD _

 , BYVAL ppmk AS DWORD PTR _

   ) AS LONG
 

ObtainUserAgentString

Determines if a specified string is a valid URL.

DECLARE FUNCTION ObtainUserAgentString _
   LIB "URLMON.DLL" _
   ALIAS "ObtainUserAgentString" ( _
   BYVAL dwOption AS DWORD _
 , BYREF pcszUAbout AS ASCIIZ _
 , BYREF cbSize AS DWORD _

   ) AS LONG
 

RegisterBindStatusCallback

Registers a callback interface with an existing bind context.

DECLARE FUNCTION RegisterBindStatusCallback _
   LIB "URLMON.DLL" _
   ALIAS "RegisterBindStatusCallback" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pbsc AS DWORD _

 , BYREF ppbscPrevious AS DWORD _

 , BYVAL dwReserved AS DWORD _

   ) AS LONG
 

RegisterFormatEnumerator

Registers a FORMATETC enumerator object onto the given bind context.

DECLARE FUNCTION RegisterFormatEnumerator _
   LIB "URLMON.DLL" _
   ALIAS "RegisterFormatEnumerator" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pEFetc AS DWORD _

 , BYVAL reserved AS DWORD _

   ) AS LONG
 

RegisterMediaTypeClass

Registers a mapping of media types to CLSIDs to override the default mapping specified in the registry.

DECLARE FUNCTION RegisterMediaTypeClass _
   LIB "URLMON.DLL" _
   ALIAS "RegisterMediaTypeClass" ( _
   BYVAL pbc AS DWORD _
 , BYVAL cTypes AS DWORD _

 , BYREF rgszTypes AS ASCIIZ _

 , BYREF rgclsID AS GUID _

 , BYVAL dwReserved AS DWORD _

  ) AS LONG
 

RegisterMediaTypes

Registers media type strings.

DECLARE FUNCTION RegisterMediaTypes _
   LIB "URLMON.DLL" _
   ALIAS "RegisterMediaTypes" ( _
   BYVAL cTypes AS DWORD _
 , BYREF rgszTypes AS ASCIIZ _

 , BYREF rgcfTypes AS DWORD _

   ) AS LONG
 

ReleaseBindInfo

Releases the resources used by the specified BINDINFO structure.

DECLARE SUB ReleaseBindInfo _
   LIB "URLMON.DLL" _
   ALIAS "ReleaseBindInfo" ( _
   BYREF pbindinfo AS BINDINFO _
   )
 

RevokeBindStatusCallback

Revokes a bind status callback interface previously registered on a bind context.

DECLARE FUNCTION RevokeBindStatusCallback _
   LIB "URLMON.DLL" _
   ALIAS "RevokeBindStatusCallback" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pbsc AS DWORD _

   ) AS LONG
 

RevokeFormatEnumerator

Removes a format enumerator from the given bind context.

DECLARE FUNCTION RevokeFormatEnumerator _
   LIB "URLMON.DLL" _
   ALIAS "RevokeFormatEnumerator" ( _
   BYVAL pbc AS DWORD _
 , BYVAL pEFetc AS DWORD _

   ) AS LONG
 

URLDownloadToCacheFile

Downloads data into the Internet cache and returns the file name of the cache location for retrieving the bits.

DECLARE FUNCTION URLDownloadToCacheFile _
   LIB "URLMON.DLL" _
   ALIAS "URLDownloadToCacheFileA" ( _
   BYVAL lpUnkcaller AS DWORD _
 , BYREF szURL AS ASCIIZ _

 , BYREF szFileName AS ASCIIZ _

 , BYVAL dwBufLength AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL pBSC AS DWORD _

   ) AS LONG

DECLARE FUNCTION URLDownloadToCacheFileW _
   LIB "URLMON.DLL" _
   ALIAS "URLDownloadToCacheFileW" ( _
   BYVAL lpUnkcaller AS DWORD _
 , BYVAL szURL AS DWORD _

 , BYVAL szFileName AS DWORD _

 , BYVAL dwBufLength AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL pBSC AS DWORD _

   ) AS LONG

URLDownloadToFile

Downloads bits from the Internet and saves them to a file.

DECLARE FUNCTION URLDownloadToFile _
   LIB "URLMON.DLL" _
   ALIAS "URLDownloadToFileA" ( _
   BYVAL pCaller AS DWORD _
 , BYVAL szURL AS ASCIIZ _

 , BYREF szFileName AS ASCIIZ _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

DECLARE FUNCTION URLDownloadToFileW _
   LIB "URLMON.DLL" _
   ALIAS "URLDownloadToFileW" ( _
   BYVAL pCaller AS DWORD _
 , BYVAL szURL AS DWORD _

 , BYVAL szFileName AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

UrlMkGetSessionOption

Sets options for the current Internet session.

DECLARE FUNCTION UrlMkGetSessionOption _
   LIB "URLMON.DLL" _
   ALIAS "UrlMkGetSessionOption" ( _
   BYVAL dwOption AS DWORD _
 , BYREF pBuffer AS ANY _

 , BYVAL dwBufferLength AS DWORD _

 , BYREF pdwBufferLength AS DWORD _

 , BYVAL dwReserved AS DWORD _

   ) AS LONG
 

UrlMkSetSessionOption

Sets options for the current Internet session.

DECLARE FUNCTION UrlMkSetSessionOption _
   LIB "URLMON.DLL" _
   ALIAS "UrlMkSetSessionOption" ( _
   BYVAL dwOption AS DWORD _
 , BYREF pBuffer AS ANY _

 , BYVAL dwBufferLength AS DWORD _

 , BYVAL dwReserved AS DWORD _

   ) AS LONG
 

URLOpenBlockingStream

Creates a blocking type stream object from a URL and downloads the data from the Internet. When the data is downloaded, the client application or control can read it using the IStream::Read method.

DECLARE FUNCTION URLOpenBlockingStream _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenBlockingStreamA" ( _
   BYVAL pCaller AS DWORD _
 , BYREF szURL AS ASCIIZ _

 , BYREF ppStream AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

DECLARE FUNCTION URLOpenBlockingStreamW _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenBlockingStreamW" ( _
   BYVAL pCaller AS DWORD _
 , BYVAL szURL AS DWORD _

 , BYREF ppStream AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

URLOpenPullStream

Creates a pull type stream object from a URL.

DECLARE FUNCTION URLOpenPullStream _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenPullStreamA" ( _
   BYVAL pCaller AS DWORD _
 , BYREF szURL AS ASCIIZ _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

DECLARE FUNCTION URLOpenPullStreamW _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenPullStreamW" ( _
   BYVAL pCaller AS DWORD _
 , BYVAL szURL AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

URLOpenStream

Creates a push type stream object from a URL.

DECLARE FUNCTION URLOpenStream _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenStreamA" ( _
   BYVAL pCaller AS DWORD _
 , BYREF szURL AS ASCIIZ _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG

DECLARE FUNCTION URLOpenStreamW _
   LIB "URLMON.DLL" _
   ALIAS "URLOpenStreamW" ( _
   BYVAL pCaller AS DWORD _
 , BYVAL szURL AS DWORD _

 , BYVAL dwReserved AS DWORD _

 , BYVAL lpfnCB AS DWORD _

   ) AS LONG