IInternetSession::RegisterNameSpace


		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.

S_OK	Success.
E_FAIL	The operation failed.
E_NOINTERFACE	The class factory could not be obtained.