Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)
| 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.