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. There 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.

Returns 0 if the broadcast was successful. A non-zero errorcode is returned if an error was encountered. This service has non-standard error return values. The valid error return values for this service are listed below.

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.