PSTARTUP_ROUTINE Rückruffunktion (resapi.h)
Lädt eine Ressourcen-DLL und gibt eine Struktur zurück, die eine Funktionstabelle und eine Versionsnummer enthält. Der PSTARTUP_ROUTINE Typ definiert einen Zeiger auf diese Funktion.
Syntax
PSTARTUP_ROUTINE PstartupRoutine;
DWORD PstartupRoutine(
[in] LPCWSTR ResourceType,
[in] DWORD MinVersionSupported,
[in] DWORD MaxVersionSupported,
[in] PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
[in] PLOG_EVENT_ROUTINE LogEvent,
[out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}
Parameter
[in] ResourceType
Art der Ressource, die gestartet wird.
[in] MinVersionSupported
Mindestversion der Ressourcen-API , die vom Clusterdienst unterstützt wird.
[in] MaxVersionSupported
Maximale Version der Ressourcen-API, die vom Clusterdienst unterstützt wird.
[in] SetResourceStatus
Zeiger auf eine Rückruffunktion, die die Ressourcen-DLL aufrufen sollte, um ihre status zu aktualisieren, nachdem ERROR_IO_PENDING aus Online oder Offline zurückgegeben wurde. Weitere Informationen finden Sie unter SetResourceStatus.
[in] LogEvent
Zeiger auf eine Rückruffunktion, die die Ressourcen-DLL aufrufen soll, um Ereignisse für die Ressource zu melden. Weitere Informationen finden Sie unter LogEvent.
[out] FunctionTable
Zeiger auf eine CLRES_FUNCTION_TABLE Struktur, die die Ressourcen-API-Version und die spezifischen Namen für die Einstiegspunkte beschreibt.
Rückgabewert
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Anforderung wurde erfolgreich gesendet. |
|
Die Ressourcen-DLL unterstützt keine Version, die in den durch die Parameter MinVersionSupported und MaxVersionSupported identifizierten Bereich fällt. |
Wenn der Vorgang nicht erfolgreich war, sollte der Start einen der Systemfehlercodes zurückgeben.
Hinweise
Die Startstart-Einstiegspunktfunktion gibt eine Funktionstabelle zurück, die sowohl die unterstützte Schnittstellenversion der Ressourcen-API als auch die Einstiegspunkte für alle anderen Funktionen beschreibt, die von der unterstützten Version der Ressourcen-API benötigt werden.
Derzeit wird nur Ressourcen-API Version 1.0 unterstützt.
Wenn Ihre Ressource mehrere Versionen der Ressourcen-API unterstützt, geben Sie eine Funktionstabelle für die neueste Version zurück. Die Versionsnummer sollte kleiner oder gleich dem MaxVersionSupported-Parameter sein. Wenn sich die Version der Funktionstabelle, auf die der FunctionTable-Parameter verweist, nicht innerhalb des Bereichs befindet, kann Ihre Ressource nicht erfolgreich geladen werden.
Weitere Informationen finden Sie unter Implementieren des Startvorgangs.
Beispiele
Weitere Informationen finden Sie unter Implementieren des Startvorgangs.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | resapi.h |