IInternetSession::RegisterNameSpace Method

Temporarily registers a pluggable namespace handler.

Syntax

HRESULT RegisterNameSpace(
    IClassFactory *pCF,
    REFCLSID rclsid,
    LPCWSTR pwzProtocol,
    ULONG cPatterns,
    const LPCWSTR *ppwzPatterns,
    DWORD dwReserved
);

Parameters

pCF

[in] Address of an IClassFactory interface where an IInternetProtocol object can be created.

rclsid

[in] Reference to the pluggable namespace handler.

pwzProtocol

[in] String value that contains the protocol to be handled.

cPatterns

[in] Unsigned long integer that indicates the number of elements in the ppwzPatterns parameter.

ppwzPatterns

[in] Array of strings containing the patterns the handler will be used for.

dwReserved

[in] Reserved. Must be set to zero.

Return Value

Returns one of the following values:

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

Remarks

An application can register a pluggable namespace 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 namespace handler will be called for all protocol requests. This method can be called multiple times using the same interface to register the different namespaces it wants to handle.

See Also

IInternetSession

Does this content meet your programming needs? Write us!

Back to top