PI_FLAGS Enumerated Type

---

Contains the flags that control the asynchronous pluggable protocol handler.

Syntax

typedef enum _tagPI_FLAGS{
    PI_PARSE_URL = 0x00000001,
    PI_FILTER_MODE = 0x00000002,
    PI_FORCE_ASYNC = 0x00000004,
    PI_USE_WORKERTHREAD = 0x00000008,
    PI_MIMEVERIFICATION = 0x00000010,
    PI_CLSIDLOOKUP = 0x00000020,
    PI_DATAPROGRESS = 0x00000040,
    PI_SYNCHRONOUS = 0x00000080,
    PI_APARTMENTTHREADED = 0x00000100,
    PI_CLASSINSTALL = 0x00000200,
    PI_PASSONBINDCTX = 0x00002000,
    PI_NOMIMEHANDLER = 0x00008000,
    PI_LOADAPPDIRECT = 0x00004000,
    PD_FORCE_SWITCH = 0x00010000
} PI_FLAGS;

Constants

PI_PARSE_URL

Asynchronous pluggable protocol should parse the URL and return S_OK if the URL is syntactically correct; otherwise S_FALSE.

PI_FILTER_MODE

Asynchronous pluggable protocol handler should be running in filter mode and data will come in through the IInternetProtocolSink interface it exposes. The QueryInterface method will be called on the protocol handler for its IInternetProtocolSink interface.

PI_FORCE_ASYNC

Asynchronous pluggable protocol handler should do as little work as possible on the apartment (or user interface) thread and continue on a worker thread as soon as possible.

PI_USE_WORKERTHREAD

Asynchronous pluggable protocol handler should use worker threads and not use the apartment thread.

PI_MIMEVERIFICATION

Asynchronous pluggable protocol handler should verify and report the MIME type.

PI_CLSIDLOOKUP

Asynchronous pluggable protocol handler should find the CLSID associated with the MIME type.

PI_DATAPROGRESS

Asynchronous pluggable protocol handler should report its progress.

PI_SYNCHRONOUS

Asynchronous pluggable protocol handler should work synchronously.

PI_APARTMENTTHREADED

Asynchronous pluggable protocol handler should use the apartment (or user interface) thread only.

PI_CLASSINSTALL

Asynchronous pluggable protocol handler should install the class if the class is not found.

PI_PASSONBINDCTX

Asynchronous pluggable protocol handler should pass address of the IBindCtx interface to the pUnk member of the PROTOCOLFILTERDATA structure.

PI_NOMIMEHANDLER

Asynchronous pluggable protocol handler should disable MIME filters.

PI_LOADAPPDIRECT

Asynchronous pluggable protocol handler should load the application directly.

PD_FORCE_SWITCH

Asynchronous pluggable protocol handler should switch to the apartment thread, even if it does not need to.

Enumerated Type Information

Windows NT	Use version 4.0
Windows	Use Windows 95 and later.
Header	Declared in Urlmon.h, Urlmon.idl.
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0