IFSMgr_PNPEvent

IFSMgr_PNPEvent(
 unsigned int Message,
 unsigned int Resource,
 unsigned int Flags
 )
 

This service broadcasts a PNP event to all devices and applications in the system. The broadcast is issued on a number of operations which are listed below. It returns the result of the operation. On query operations, an error is returned if any of the recipients of the broadcast refuses the query. Valid devices include local and net drives as well as network transports and resources. When a network transport or resource is removed, all drives attached to them are removed as well.

Message
Supplies the operation for which the broadcast is being issued. The defined operations are described below.
Message Values:  
Value Meaning
DBT_DEVICEARRIVAL The system has detected a new device.
DBT_DEVICEQUERYREMOVE The system is in the process of querying a device for removal. This may be failed by any recipient of the broadcast.
DBT_DEVICEQUERYREMOVEFAILED The query for removal of the device was failed. The device will not be removed.
DBT_DEVICEREMOVEPENDING The device is in the process of being removed, but is still available.
DBT_DEVICEREMOVECOMPLETE The device has been removed from the system.
DBT_TYPESPECIFIC This is a type specific event, currently unimplemented.

Resource
Supplies the 0-based drive number of a volume-based device that is going away or the resource identification of the network transport or resource that is going away.
Flags
Supplies various flags for the broadcast.
Flag Values:  
Value Meaning
PNPT_VOLUME Indicates a PNP volume is going away. There are supplemental flags that can be set along with this flag.

Supplemental Flag Values:  
Value Meaning
DBTF_VOLUME Indicates that a local volume is going away.
DBTF_NET Indicates that a network volume is going away.
PNPT_NET Indicates the a network resource or transport is going away. There are supplemental flags that indicate exactly which system component is being removed.

Supplemental Flags Values:  
Value Meaning
DBTF_RESOURCE Indicates that a network resource is going away.
DBTF_XPORT Indicates that a network transport is going away.

Error Return Values:  
Value Meaning
PNPE_QUERY_REFUSED The query request was rejected by at least one of the recipients.
PNPE_BAD_ARGS Bad parameters were passed as input to the service.
PNPE_UNDEFINED An undefined error was encountered during the broadcast.