PRESOURCE_CONTROL_ROUTINE fonction de rappel (resapi.h)

Article
08/25/2023

Effectue une opération qui s’applique à une ressource. Le type PRESOURCE_CONTROL_ROUTINE définit un pointeur vers cette fonction.

Syntaxe

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

Paramètres

[in] Resource

Identificateur de ressource de la ressource affectée.

[in] ControlCode

Code de contrôle qui représente l’opération à effectuer. Pour obtenir la liste des valeurs valides pour le paramètre ControlCode , consultez Codes de contrôle de type de ressource.

[in, optional] InBuffer

Pointeur vers une mémoire tampon contenant des données à utiliser dans l’opération. InBuffer peut avoir la valeur NULL si aucune donnée n’est requise.

[in] InBufferSize

Taille, en octets, de la mémoire tampon pointée par InBuffer.

[out, optional] OutBuffer

Pointeur vers une mémoire tampon contenant des données résultant de l’opération. OutBuffer peut avoir la valeur NULL si l’opération n’a pas besoin de retourner des données.

[in] OutBufferSize

Taille, en octets, de l’espace disponible indiqué par OutBuffer.

[out] BytesReturned

Taille réelle, en octets, des données résultant de l’opération.

Valeur retournée

Code/valeur de retour	Description
ERROR_SUCCESS 0	L’opération associée à ControlCode s’est terminée avec succès.
ERROR_INVALID_FUNCTION 1	La DLL de ressource a demandé au Moniteur de ressources d’effectuer le traitement par défaut (le cas échéant) pour ControlCode en plus du traitement fourni par la DLL (le cas échéant).
ERROR_MORE_DATA 234 (0xEA)	La taille allouée d’OutBuffer était trop petite pour contenir les données demandées. BytesReturned indique la taille requise. Incluez toujours la valeur NULL de fin lors du calcul des tailles d’octets des chaînes.
ERROR_RESOURCE_PROPERTIES_STORED 5024 (0x13A0)	Indique que les nouvelles valeurs de propriété d’une ressource ont été définies dans la base de données du cluster, mais que les propriétés n’ont pas encore pris effet. Les nouvelles valeurs de propriété seront appliquées une fois la ressource mise hors connexion et mise en ligne.
Code d’erreur	L'opération a échoué.

Remarques

Certains codes de contrôle doivent être gérés par la DLL de ressource, tandis que d’autres doivent être laissés au moniteur de ressources. Pour obtenir des stratégies d’implémentation efficaces de la fonction point d’entrée ResourceControl , consultez Implémentation de ResourceControl.

Exemples

Consultez Exemples de DLL de ressources.

Configuration requise

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

Voir aussi

Dll de ressources Entry-Point Functions

Partager via