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

Weitere Informationen

LogEvent

Ressourcen-DLL Entry-Point Funktionen

SetResourceStatus