Contents Index Topic Contents | ||
Previous Topic: IInternetSession::RegisterMimeFilter Next Topic: IInternetSession::SetCache |
IInternetSession::RegisterNameSpace
HRESULT RegisterNameSpace( [in] IClassFactory *pCF, [in] REFCLSID rclsid, [in] LPCWSTR pwzProtocol, [in] ULONG cPatterns, [in] const LPCWSTR *ppwzPatterns, [in] DWORD dwReserved );Temporarily registers a pluggable name space handler.
- Returns one of the following values:
S_OK Success. E_FAIL The operation failed. E_NOINTERFACE The class factory could not be obtained.
- pCF
- Address of an IClassFactory interface where an IInternetProtocol object can be created.
- rclsid
- Reference to the pluggable name space handler.
- pwzProtocol
- String value that contains the protocol to be handled.
- cPatterns
- Unsigned long integer that indicates the number of elements in the ppwzPatterns parameter.
- ppwzPatterns
- Array of strings containing the patterns the handler will be used for.
- dwReserved
- Reserved. Must be set to zero.
An application can register a pluggable name space handler for a particular period when it wants to handle requests for some protocols by calling IInternetSession::RegisterNameSpace. If ppwzPatterns and cPatterns are NULL, the registered pluggable name space handler will be called for all protocol requests. This method can be called multiple times using the same interface to register the different name spaces it wants to handle.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.