CM_WaitNoPendingInstallEvents-Funktion (cfgmgr32.h)
Die funktion CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) wartet, bis keine ausstehenden Geräteinstallationsaktivitäten für den PnP-Manager ausgeführt werden können.
Syntax
DWORD CM_WaitNoPendingInstallEvents(
[in] DWORD dwTimeout
);
Parameter
[in] dwTimeout
Gibt ein Timeoutintervall in Millisekunden an.
- Wenn dwTimeout auf 0 festgelegt ist, testet die Funktion, ob ausstehende Installationsereignisse vorhanden sind, und gibt sofort zurück.
- Wenn dwTimeout auf INFINITE (definiert in Winbase.h) festgelegt ist, verstreicht das Timeoutintervall der Funktion nie.
- Für alle anderen dwTimeout-Werte gibt die Funktion zurück, wenn das angegebene Intervall verstrichen ist, auch wenn noch Installationsereignisse ausstehen.
Rückgabewert
Die Funktion gibt einen der folgenden Werte zurück (definiert in Winbase.h):
| Rückgabecode | Beschreibung |
|---|---|
|
Es gibt keine ausstehenden Installationsaktivitäten. |
|
Das Timeoutintervall ist verstrichen, und die Installationsaktivitäten stehen noch aus. |
|
Fehler bei der Funktion. Rufen Sie GetLastError auf, um weitere Fehlerinformationen zu erhalten. |
Hinweise
Die Funktion wartet auf ein internes Ereignisobjekt, das der PnP-Manager festlegt, wenn er feststellt, dass keine Installationsaktivitäten ausstehen.
Wenn ein Timeoutwert ungleich Null angegeben wird, gibt CMP_WaitNoPendingInstallEvents entweder zurück, wenn keine Installationsereignisse ausstehen oder wenn der Timeoutzeitraum abgelaufen ist, je nachdem, welcher Zeitpunkt zuerst eintritt.
Neue Installationsereignisse können jederzeit auftreten. Diese Funktion gibt nur an, dass zum Zeitpunkt des Aufrufs keine Installationsaktivitäten ausstehen.
Diese Funktion wird in der Regel von Geräteinstallationsanwendungen verwendet. Weitere Informationen finden Sie unter Schreiben einer Geräteinstallationsanwendung.
Rufen Sie diese Funktion nicht auf, während Ereignisse innerhalb einer systeminitiierte Rückruffunktion verarbeitet werden, die voraussichtlich innerhalb kurzer Zeit zurückgegeben werden. Dies schließt das Starten des Diensts (z. B. in der ServiceMain-Rückruffunktion ) oder die Verarbeitung eines beliebigen Steuerelements im Diensthandler (z. B. der Handler-Rückruffunktion ) oder aus Installationskomponenten wie Klasseninstallationsprogrammen oder Co-Installern ein.
Für Windows XP (ohne installiertes Service Pack) muss diese Funktion von Session Zero mit Administratorrechten aufgerufen werden. Bei Windows XP mit Service Pack 1 (SP1) und höheren Versionen von Windows kann die Funktion aus jeder Sitzung aufgerufen werden, und Administratorrechte sind nicht erforderlich.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows XP und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | cfgmgr32.h (einschließlich Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |
| DLL | Cfgmgr32.dll |
Weitere Informationen
So überprüft eine Geräteinstallationsanwendung auf laufende Geräteinstallationen