OLE DB Programmer's Reference | |
Returns the CLSID of the provider binder object that is mapped to a URL scheme or scheme and prefix.
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," in Chapter 8, discusses case-sensitivity issues for URL-to-provider mapping.
1998-2001 Microsoft Corporation. All rights reserved.