PONLINE_V2_ROUTINE fonction de rappel (resapi.h)

Article
03/01/2024

Marque une ressource comme étant disponible pour une utilisation. Le type PONLINE_V2_ROUTINE définit un pointeur vers cette fonction.

Syntaxe

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
)
{...}

Paramètres

[in] Resource

Identificateur de ressource pour la ressource à rendre disponible.

[out] EventHandle

Lors de l’entrée, EventHandle a la valeur NULL. Lors de la sortie, EventHandle contient un handle pour un objet de synchronisation non signalé. La DLL de ressource peut signaler ce handle à tout moment pour signaler une défaillance de ressource au moniteur de ressources. EventHandle peut également être défini sur NULL lors de la sortie, ce qui indique que la ressource ne prend pas en charge les notifications d’événements asynchrones.

[in] OnlineFlags

Masque de bits d’indicateurs qui spécifient les paramètres pour cette opération. Ce paramètre peut être défini sur une ou plusieurs des valeurs suivantes :

CLUS_RESDLL_ONLINE_RECOVER_MONITOR_STATE (0x00000001)

Surveillez l’état de la ressource si la ressource est en cours de récupération à la suite d’une erreur.

CLUS_RESDLL_ONLINE_IGNORE_RESOURCE_STATUS (0x00000002)

Effectuez l’opération même si la ressource indique qu’elle doit être verrouillée.

CLUS_RESDLL_ONLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000004)

Si la ressource rencontre une erreur, retournez-la au nœud source.

CLUS_RESDLL_ONLINE_RESTORE_ONLINE_STATE (0x00000008)

Définissez la status de la ressource sur en ligne.

CLUS_RESDLL_ONLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000010)

Effectuez l’opération même en cas d’erreur réseau.

[in, optional] InBuffer

Pointeur vers une mémoire tampon qui contient des données pour l’opération ; sinon NULL si l’opération ne nécessite pas de données.

[in] InBufferSize

Taille du paramètre InBuffer , en octets.

[in] Reserved

Réservé.

Valeur retournée

Code/valeur de retour	Description
ERROR_SUCCESS 0	L’opération a réussi et la ressource est en ligne.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	La ressource a été arbitrée avec d’autres systèmes, et l’un des autres systèmes a remporté l’arbitrage. Seules les ressources compatibles avec quorum retournent cette valeur.
ERROR_IO_PENDING 997 (0x3E5)	La demande est en attente et un thread a été activé pour traiter la demande en ligne.

Si l’opération n’a pas réussi pour d’autres raisons, un code d’erreur système est retourné.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2012 R2
Plateforme cible	Windows
En-tête	resapi.h

Voir aussi

Fonctions Entry-Point dll de ressource

Partager via