Méthode CVssWriter ::GetSnapshotDeviceName (vswriter.h)

Article
03/03/2024

La méthode GetSnapshotDeviceName retourne le nom de l’appareil qui héberge le cliché instantané du volume ou du partage de fichiers spécifié. Cette méthode permet aux enregistreurs de prendre en charge la récupération automatique des clichés instantanés et ne peut être appelée que pendant le traitement de la méthode OnPostSnapshot .

Syntaxe

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Paramètres

[in] wszOriginalVolume

Nom du volume d’origine ou du chemin UNC du partage de fichiers d’origine qui contient les données utilisées pour le jeu de cliché instantané actuel. Le nom du volume doit être dans l’un des formats suivants et doit inclure une barre oblique inverse de fin (\) :

Chemin d’accès d’un dossier monté, par exemple, Y :\MountX\
Lettre de lecteur, par exemple, D :\
Chemin d’accès GUID de volume de la forme \\ ?\Volume{GUID}\ (où GUID identifie le volume)
Chemin UNC qui spécifie un partage de fichiers distant, par exemple, \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Adresse d’un LPCWSTR qui recevra un pointeur vers le nom de l’appareil du cliché instantané.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	Le nom du volume de cliché instantané a été renvoyé.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
VSS_E_BAD_STATE	L’appel n’a pas été effectué pendant l’événement PostSnapshot.
VSS_E_OBJECT_NOT_FOUND	Le paramètre wszOriginalVolume n’est pas l’un des volumes ou partages de fichiers du jeu de cliché instantané.

Remarques

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP et Windows Server 2003 : Les partages de fichiers distants ne sont pas pris en charge tant que Windows 8 et Windows Server 2012.

Pour obtenir le nom du volume d’origine pour le paramètre wszOriginalVolume , appelez d’abord la méthode CVssWriter ::GetCurrentVolumeCount pour interroger le nombre de volumes dans le jeu de cliché instantané. Appelez ensuite la méthode CVssWriter ::GetCurrentVolumeArray pour énumérer les noms d’origine des volumes dans le jeu de clichés instantanés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Partager via