PONLINE_ROUTINE Rückruffunktion (resapi.h)
Markiert eine Ressource als verfügbar für die Verwendung. Der PONLINE_ROUTINE Typ definiert einen Zeiger auf diese Funktion.
Syntax
PONLINE_ROUTINE PonlineRoutine;
DWORD PonlineRoutine(
[in] RESID Resource,
[in, out] LPHANDLE EventHandle
)
{...}
Parameter
[in] Resource
Ressourcenbezeichner für die ressource, die verfügbar gemacht werden soll.
[in, out] EventHandle
Bei der Eingabe ist EventHandleNULL. Bei der Ausgabe enthält EventHandle ein Handle für ein nicht signaliertes Synchronisierungsobjekt. Die Ressourcen-DLL kann dieses Handle jederzeit signalisieren, um dem Ressourcenmonitor einen Ressourcenfehler zu melden. EventHandle kann auch in der Ausgabe auf NULL festgelegt werden, was angibt, dass die Ressource keine asynchrone Ereignisbenachrichtigung unterstützt.
Rückgabewert
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang war erfolgreich, und die Ressource ist jetzt online. |
|
Die Ressource wurde mit einigen anderen Systemen schlichtet, und eines der anderen Systeme gewann das Schiedsverfahren. Nur quorumfähige Ressourcen geben diesen Wert zurück. |
|
Die Anforderung ist ausstehend, und ein Thread wurde aktiviert, um die Onlineanforderung zu verarbeiten. |
Wenn der Vorgang aus anderen Gründen nicht erfolgreich war, sollte Online einen der Systemfehlercodes zurückgeben.
Hinweise
Wenn die Online-Einstiegspunktfunktion einen anderen Fehlercode als ERROR_IO_PENDING zurückgibt, protokolliert der Ressourcenmonitor ein Ereignis und ruft Terminate auf.
Die Rückgabe eines gültigen EventHandle-Werts ergibt die folgenden Vorteile:
- Der Ressourcenmonitor führt keine LooksAlive-Abfrage aus. Die Vermeidung dieses Mehraufwands ist häufig hilfreich, insbesondere wenn Ihre DLL mehrere Ressourceninstanzen unterstützt.
- Sie können ressourcenfehler jederzeit melden, indem Sie das Handle signalisieren. Der Ressourcenmonitor ruft sofort IsAlive auf, um zu überprüfen, ob die Ressource fehlgeschlagen ist.
Beispiele
Weitere Informationen finden Sie unter Ressourcen-DLL-Beispiele.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |