Méthode IVssHardwareSnapshotProvider ::LocateLuns (vsprov.h)
La méthode LocateLuns invite le fournisseur de matériel à rendre les lun de cliché instantané visibles sur l’ordinateur. La méthode LocateLuns est appelée par VSS lorsqu’un jeu de clichés instantanés matériels est importé sur un ordinateur. Le fournisseur est responsable de tout démasquage (ou « mise en surface ») au niveau du matériel.
Syntaxe
HRESULT LocateLuns(
[in] LONG lLunCount,
[in] VDS_LUN_INFORMATION *rgSourceLuns
);
Paramètres
[in] lLunCount
Nombre de LUN qui contribuent à ce jeu de clichés instantanés.
[in] rgSourceLuns
Pointeur vers un tableau de structures iLunCountVDS_LUN_INFORMATION , une pour chaque LUN faisant partie du jeu de cliché instantané à importer.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code/valeur de retour | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
Mémoire insuffisante ou autres ressources système. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
Une erreur de fournisseur inattendue s’est produite. Le fournisseur doit signaler un événement dans le journal des événements de l’application, fournissant à l’utilisateur des informations sur la façon de résoudre le problème. |
Remarques
Dans le paramètre rgSourceLuns , VSS fournit le même tableau de structures VDS_LUN_INFORMATION que le fournisseur initialisé précédemment dans sa méthode IVssHardwareSnapshotProvider ::GetTargetLuns . Pour chaque structure VDS_LUN_INFORMATION dans le tableau, le fournisseur doit démasquer (ou « surface ») la lun de cliché instantané correspondant sur l’ordinateur.
Immédiatement après le retour de cette méthode, VSS effectue une nouvelle analyse et une énumération pour détecter tous les appareils arrivés. Cela entraîne la découverte de toutes les LUN exposées par le gestionnaire PnP. Parallèlement à l’écoute des arrivées de disque, VSS écoute également les arrivées de volume masquées. VSS cessera d’écouter une fois que tous les volumes qui contribuent à un jeu de cliché instantané apparaissent dans le système ou qu’un délai d’attente se produit. Si certains disques ou périphériques de volume ne parviennent pas à s’afficher dans cette fenêtre, le demandeur sera informé que seuls certains clichés instantanés ont été importés par VSS retournant VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED au demandeur. Le demandeur reçoit également la même erreur de VSS si les structures VDS_LUN_INFORMATION reçues des méthodes GetTargetLuns et IVssHardwareSnapshotProvider ::FillInLunInfo ne correspondent pas.
Cette méthode ne peut pas être utilisée pour mapper des LUN de cliché instantané en lecture seule.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vsprov.h |