通过

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.