Méthode IVssComponentEx2 ::GetFailure (vswriter.h)

Article
03/03/2024

Les demandeurs VSS appellent cette méthode pour récupérer les erreurs au niveau des composants signalées par les enregistreurs.

Syntaxe

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

Paramètres

[out] phr

Adresse d’une variable allouée par l’appelant qui reçoit le code d’échec HRESULT que l’enregistreur a passé pour le paramètre hr de la méthode IVssComponentEx2 ::SetFailure . Ce paramètre est obligatoire et ne peut pas être NULL.

Voici les valeurs prises en charge.

Valeur	Signification
S_OK	L’auteur a réussi.
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	Le cliché instantané contient uniquement un sous-ensemble des volumes nécessaires à l’enregistreur pour sauvegarder correctement le composant d’application.
VSS_E_WRITERERROR_OUTOFRESOURCES	L’enregistreur est à court de mémoire ou d’autres ressources système. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_TIMEOUT	L’opération writer a échoué en raison d’un délai d’attente entre les événements Freeze et Thaw. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_RETRYABLE	L’enregistreur a échoué en raison d’une erreur qui ne se produirait probablement pas si l’ensemble du processus de sauvegarde, de restauration ou de création de cliché instantané était redémarré. La méthode recommandée pour gérer ce code d’erreur consiste à attendre dix minutes, puis à répéter l’opération, jusqu’à trois fois.
VSS_E_WRITERERROR_NONRETRYABLE	L’opération writer a échoué en raison d’une erreur qui peut se reproduire si un autre cliché instantané est créé. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_WRITER_NOT_RESPONDING	L’auteur ne répond pas.
VSS_E_WRITER_STATUS_NOT_AVAILABLE	Le writer status n’est pas disponible pour un ou plusieurs écrivains. Un enregistreur peut avoir atteint le nombre maximal de sessions de sauvegarde et de restauration disponibles.

[out] phrApplication

Adresse d’une variable allouée par l’appelant qui reçoit le code de retour que l’enregistreur a passé pour le paramètre hrApplication de la méthode SetFailure . Ce paramètre est obligatoire et ne peut pas être NULL.

[out] pbstrApplicationMessage

Adresse d’une variable allouée à l’appelant qui reçoit le message d’échec de l’application que l’enregistreur a passé pour le paramètre wszApplicationMessage de la méthode SetFailure . Ce paramètre est obligatoire et ne peut pas être NULL.

[out] pdwReserved

Adresse d’une variable DWORD allouée par l’appelant. Ce paramètre est réservé pour une utilisation ultérieure, mais il est obligatoire et ne peut pas être NULL.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK 0x00000000L	La status de l’enregistreur spécifié a été correctement retournée. Notez que la valeur du paramètre phrFailureWriter doit être vérifiée pour vérifier que l’enregistreur a réussi. Les codes d’échec de l’enregistreur peuvent figurer parmi ceux répertoriés dans VsWriter.h et dans Les erreurs et les vetos de l’enregistreur.
E_INVALIDARG 0x80070057L	Le paramètre phr, phrApplication, pbstrApplicationMessage ou pdwReserved est NULL.
E_OUTOFMEMORY 0x8007000EL	L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE 0x80042301L	L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée pendant une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte.

Remarques

Lorsque l’appelant a terminé d’accéder aux informations status retournées par cette méthode, il doit appeler SysFreeString pour libérer la mémoire détenue par le paramètre pbstrApplicationMessage.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h

Voir aussi

IVssComponentEx2

Partager via