IRegisterProvider::GetURLMapping
Returns the CLSID of the provider binder object that is mapped to a URL scheme or scheme and prefix.
Syntax
HRESULT GetURLMapping(
LPCOLESTR pwszURL,
DB_DWRESERVE dwReserved,
CLSID *pclsidProvider
);
Parameters
pwszURL
[in] The canonical URL scheme or scheme and prefix whose mapping is to be returned.dwReserved
[in] Reserved for future use; caller should set this to zero.pclsidProvider
[out] A pointer to the CLSID of the provider binder object that is mapped to this URL scheme or scheme and prefix. *pclsidProvider is set to DB_NULLGUID if an error code is returned.
Return Code
S_OK
The method succeeded. pclsidProvider points to the CLSID of the provider binder object.S_FALSE
No provider binder object was mapped to this URL scheme or scheme and prefix. *pclsidProvider is set to DB_NULLGUID.E_FAIL
A provider-specific error occurred.E_INVALIDARG
pwszURL or pclsidProvider was a null pointer.dwReserved was not 0.
Comments
Each URL scheme and prefix combination may be mapped to at most a single OLE DB provider binder object.
Note
Provider Binder Objects discusses case-sensitivity issues for URL-to-provider mapping.