Méthode IVssHardwareSnapshotProvider ::LocateLuns (vsprov.h)

  • Article

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.

Note Les fournisseurs de matériel sont uniquement pris en charge sur les systèmes d’exploitation Windows Server.
 

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
S_OK
0x000000000L
 L’opération s’est terminée avec succès.
E_OUTOFMEMORY
0x8007000EL
 Mémoire insuffisante ou autres ressources système.
E_INVALIDARG
0x80070057L
 L’une des valeurs de paramètre n’est pas valide.
VSS_E_PROVIDER_VETO
0x80042306L
 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

Voir aussi

AreLunsSupported

FillInLunInfo

GetTargetLuns

IVssHardwareSnapshotProvider

VDS_LUN_INFORMATION