OLE DB Programmer's Reference |
Registers the ability of a provider binder object to process a particular URL scheme or scheme and prefix.
HRESULT SetURLMapping( LPCOLESTR pwszURL, DB_DWRESERVE dwReserved, REFCLSID rclsidProvider );
Parameters
Return Code
dwReserved was not 0.
Comments
Each URL scheme or scheme and prefix combination may be mapped to at most a single OLE DB provider. A URL scheme and prefix may be mapped to the same provider multiple times; however, the root binder should return S_OK on each call.
Note "Provider Binder Objects" in Chapter 8, discusses case-sensitivity issues for URL-to-provider mapping.
IRegisterProvider::SetURLMapping uses InternetCrackUrl to validate URLs for mapping. In addition to the URLs accepted by InternetCrackUrl, IRegisterProvider::SetURLMapping accepts scheme-only URLs such as "http", "http:", "myscheme" and "myscheme:".
For more information about InternetCrackUrl, see the MSDN Library documentation.
1998-2001 Microsoft Corporation. All rights reserved.