POFFLINE_V2_ROUTINE fonction de rappel (resapi.h)

Article
03/01/2024

Marque une ressource comme indisponible une fois le traitement du nettoyage terminé. Le type POFFLINE_V2_ROUTINE définit un pointeur vers cette fonction.

Syntaxe

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

Paramètres

[in] Resource

Identificateur de ressource pour la ressource à mettre hors connexion.

[in, optional] DestinationNodeName

Nom du nœud qui doit contenir la ressource une fois l’opération terminée.

[in] OfflineFlags

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

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS (0x00000001)

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

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR (0x00000002)

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

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED (0x00000004)

Mettre en file d’attente l’opération si elle est retardée par une DLL de ressource, puis réessayer jusqu’à ce qu’elle se termine ou soit annulée par le client.

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR (0x00000008)

Indiquez que la ressource a rencontré une erreur et qu’elle retourne au nœud source.

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE (0x00000010)

Indiquez qu’il y a eu une défaillance incorporée.

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY (0x00000020)

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

Windows Server 2012 : cette valeur n’est pas prise en charge avant Windows Server 2012 R2.

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000040)

Ne mettez pas à jour l’état persistant de la ressource.

Windows Server 2012 R2 et Windows Server 2012 : cette valeur n’est pas prise en charge avant Windows Server 2016.

[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	La demande s’est terminée correctement et la ressource est hors connexion.
ERROR_IO_PENDING 997 (0x3E5)	La demande est toujours en attente et un thread a été activé pour traiter la demande hors connexion.

Si l’opération n’a pas réussi pour d’autres raisons, cette fonction retourne l’un des codes d’erreur système.

Configuration requise

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

Voir aussi

Fonctions de point d’entrée de la DLL de ressource

Partager via