POPEN_ROUTINE Rückruffunktion (resapi.h)
Öffnet eine Ressource. Der POPEN_ROUTINE-Typs definiert einen Zeiger auf diese Funktion.
Syntax
POPEN_ROUTINE PopenRoutine;
RESID PopenRoutine(
[in] LPCWSTR ResourceName,
[in] HKEY ResourceKey,
[in] RESOURCE_HANDLE ResourceHandle
)
{...}
Parameter
[in] ResourceName
Name der zu öffnenden Ressource.
[in] ResourceKey
Clusterdatenbankschlüssel für den Cluster , der die durch ResourceName dargestellte Ressource enthält.
[in] ResourceHandle
Handle, das an die Rückruffunktion SetResourceStatus in der Starteinstiegsfunktion übergeben werden soll.
Rückgabewert
Wenn der Vorgang erfolgreich war, gibt Open einen Ressourcenbezeichner (RESID) zurück.
Wenn der Vorgang nicht erfolgreich war, gibt OpenNULL zurück. Rufen Sie SetLastError auf, um anzugeben, dass ein Fehler aufgetreten ist.
Hinweise
Die Open-Einstiegspunktfunktion öffnet eine Ressource mit dem durch den ResourceName-Parameter identifizierten Namen und gibt ihren Ressourcenbezeichner zurück. Der Ressourcenbezeichner kann in zukünftigen Aufrufen anderer Ressourcen-API-Einstiegspunkte verwendet werden, um die Ressource zu identifizieren.
Schließen Sie niemals das durch den ResourceHandle-Parameter dargestellte Handle, oder verwenden Sie es nicht für einen anderen Zweck als die Übergabe an den Ressourcenmonitor über die LogEvent-Rückruffunktion oder die Rückruffunktion SetResourceStatus .
Effektive Implementierungsstrategien der Open-Einstiegsfunktion finden Sie unter Implementieren von Open.
Beispiele
Weitere Informationen finden Sie unter Beispiele für Ressourcen-DLL.
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 |