PSTARTUP_ROUTINE fonction de rappel (resapi.h)

Article
08/25/2023

Charge une DLL de ressource, renvoyant une structure contenant une table de fonctions et un numéro de version. Le type PSTARTUP_ROUTINE définit un pointeur vers cette fonction.

Syntaxe

PSTARTUP_ROUTINE PstartupRoutine;

DWORD PstartupRoutine(
  [in]  LPCWSTR ResourceType,
  [in]  DWORD MinVersionSupported,
  [in]  DWORD MaxVersionSupported,
  [in]  PSET_RESOURCE_STATUS_ROUTINE SetResourceStatus,
  [in]  PLOG_EVENT_ROUTINE LogEvent,
  [out] PCLRES_FUNCTION_TABLE *FunctionTable
)
{...}

Paramètres

[in] ResourceType

Type de ressource en cours de démarrage.

[in] MinVersionSupported

Version minimale de l’API de ressource prise en charge par le service cluster.

[in] MaxVersionSupported

Version maximale de l’API de ressource prise en charge par le service cluster.

[in] SetResourceStatus

Pointeur vers une fonction de rappel que la DLL de ressource doit appeler pour mettre à jour son status après avoir retourné ERROR_IO_PENDING à partir de Online ou Offline. Pour plus d’informations, consultez SetResourceStatus.

[in] LogEvent

Pointeur vers une fonction de rappel que la DLL de ressource doit appeler pour signaler des événements pour la ressource. Pour plus d’informations, consultez LogEvent.

[out] FunctionTable

Pointeur vers une structure CLRES_FUNCTION_TABLE qui décrit la version de l’API Resource et les noms spécifiques des points d’entrée.

Valeur retournée

Code/valeur de retour	Description
ERROR_SUCCESS 0	La demande a abouti.
ERROR_REVISION_MISMATCH 1306 (0x51A)	La DLL de ressource ne prend pas en charge une version qui se situe dans la plage identifiée par les paramètres MinVersionSupported et MaxVersionSupported .

Si l’opération n’a pas réussi, le démarrage doit retourner l’un des codes d’erreur système.

Notes

La fonction Point d’entrée de démarrage retourne une table de fonctions qui décrit à la fois la version d’interface prise en charge de l’API Resource et les points d’entrée pour toutes les autres fonctions requises par la version prise en charge de l’API Resource.

À l’heure actuelle, seule la version 1.0 de l’API resource est prise en charge.

Si votre ressource prend en charge plusieurs versions de l’API Resource, retournez une table de fonction pour la dernière version. Le numéro de version doit être inférieur ou égal au paramètre MaxVersionSupported . Si la version de la table de fonctions pointée par le paramètre FunctionTable ne se trouve pas dans la plage, votre ressource ne peut pas être chargée correctement.

Pour plus d’informations, consultez Implémentation du démarrage.

Exemples

Consultez Implémentation du démarrage.

Spécifications


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