PONLINE_V2_ROUTINE Rückruffunktion (resapi.h)

Artikel
08/25/2023

Markiert eine Ressource als verfügbar für die Verwendung. Der PONLINE_V2_ROUTINE Typ definiert einen Zeiger auf diese Funktion.

Syntax

PONLINE_V2_ROUTINE PonlineV2Routine;

DWORD PonlineV2Routine(
  [in]           RESID Resource,
  [out]          LPHANDLE EventHandle,
  [in]           DWORD OnlineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Parameter

[in] Resource

Ein Ressourcenbezeichner für die ressource, die verfügbar gemacht werden soll.

[out] EventHandle

Bei der Eingabe ist EventHandleNULL. Bei der Ausgabe enthält EventHandle ein Handle für ein nicht signalisiertes 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 asynchronen Ereignisbenachrichtigungen unterstützt.

[in] OnlineFlags

Eine Bitmaske von Flags, die Einstellungen für diesen Vorgang angeben. Dieser Parameter kann auf einen oder mehrere der folgenden Werte festgelegt werden:

CLUS_RESDLL_ONLINE_RECOVER_MONITOR_STATE (0x00000001)

Überwachen Sie den Status der Ressource, wenn die Ressource nach einem Fehler wiederhergestellt wird.

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

Führen Sie den Vorgang auch dann aus, wenn die Ressource angibt, dass sie gesperrt werden soll.

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

Wenn für die Ressource ein Fehler auftritt, kehren Sie sie an den Quellknoten zurück.

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

Legen Sie die status der Ressource auf online fest.

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

Führen Sie den Vorgang auch dann aus, wenn ein Netzwerkfehler vorliegt.

[in, optional] InBuffer

Ein Zeiger auf einen Puffer, der Daten für den Vorgang enthält; andernfalls NULL , wenn für den Vorgang keine Daten erforderlich sind.

[in] InBufferSize

Die Größe des InBuffer-Parameters in Bytes.

[in] Reserved

Reserviert.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang war erfolgreich, und die Ressource ist online.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	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.
ERROR_IO_PENDING 997 (0x3E5)	Die Anforderung ist ausstehend, und ein Thread wurde aktiviert, um die Onlineanforderung zu verarbeiten.

Wenn der Vorgang aus anderen Gründen nicht erfolgreich war, wird ein Systemfehlercode zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2012 R2
Zielplattform	Windows
Kopfzeile	resapi.h

Weitere Informationen

Ressourcen-DLL Entry-Point Functions

Freigeben über