Partager via


Fonction ClusterPrepareSharedVolumeForBackup (resapi.h)

[ClusterPrepareSharedVolumeForBackup peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Un appel à cette fonction n’est pas nécessaire. La fonction ne fait rien d’autre que récupérer le chemin du volume et le nom du volume.

Windows Server 2008 R2 : Prépare un volume partagé de cluster (CSV) pour la sauvegarde. Cela permet de monter le csv localement, de l’épingler à ce nœud de cluster, de désactiver les E/S directes et de définir l’état du volume sur « Sauvegarde en cours ».

Syntaxe

DWORD ClusterPrepareSharedVolumeForBackup(
  [in]      LPCWSTR lpszFileName,
  [out]     LPWSTR  lpszVolumePathName,
  [in, out] LPDWORD lpcchVolumePathName,
  [out]     LPWSTR  lpszVolumeName,
  [in, out] LPDWORD lpcchVolumeName
);

Paramètres

[in] lpszFileName

Chemin d’accès à un répertoire ou à un fichier sur un volume partagé de cluster.

[out] lpszVolumePathName

Adresse de la mémoire tampon qui recevra le point d’analyse CSV.

[in, out] lpcchVolumePathName

Adresse d’un DWORD qui, à l’entrée, contient la taille de la mémoire tampon (en caractères WCHAR ) pointée par le paramètre lpszVolumePathName et, sur la sortie, contient la taille de la chaîne écrite dans cette mémoire tampon. Si la taille de l’entrée n’est pas suffisamment grande, la fonction échoue et retourne ERROR_MORE_DATA et définit la taille requise pour DWORD .

[out] lpszVolumeName

Adresse de la mémoire tampon qui recevra le chemin d’accès GUID du volume pour le fichier CSV.

[in, out] lpcchVolumeName

Adresse d’un DWORD qui, à l’entrée, contient la taille de la mémoire tampon (en caractères WCHAR ) pointée par le paramètre lpszVolumeName et, sur la sortie, contient la taille de la chaîne écrite dans cette mémoire tampon. Si la taille de l’entrée n’est pas suffisamment grande, la fonction échoue et retourne ERROR_MORE_DATA et définit la taille requise pour DWORD .

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne l’un des codes d’erreur système.

Notes

La fonction ClusterPrepareSharedVolumeForBackup doit être appelée à partir d’un nœud du cluster.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 Entreprise, Windows Server 2008 R2 Datacenter
Plateforme cible Windows
En-tête resapi.h
Bibliothèque ResUtils.Lib
DLL ResUtils.Dll

Voir aussi

Sauvegarde et restauration de la configuration du cluster de basculement à l’aide de VSS

Fonctions de sauvegarde et de restauration