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