Fonction ClusterGetVolumePathName (resapi.h)

Article
03/01/2024

[ClusterGetVolumePathName peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt GetVolumePathName.]

Récupère le point de montage du volume sur le cluster où le chemin spécifié est monté.

Syntaxe

BOOL ClusterGetVolumePathName(
  [in]  LPCWSTR lpszFileName,
  [out] LPWSTR  lpszVolumePathName,
  [in]  DWORD   cchBufferLength
);

Paramètres

[in] lpszFileName

Pointeur vers la chaîne de chemin d’entrée. Les noms de fichiers et de répertoires absolus et relatifs, par exemple « ». sont acceptables dans ce chemin d’accès.

Si vous spécifiez un répertoire ou un nom de fichier relatif sans qualificateur de volume, ClusterGetVolumePathName renvoie la lettre de lecteur du volume actuel.

Si ce paramètre est une chaîne vide, « », la fonction échoue, mais la dernière erreur est définie sur ERROR_SUCCESS.

[out] lpszVolumePathName

Pointeur vers une chaîne qui reçoit le point de montage du volume pour le chemin d’entrée.

[in] cchBufferLength

Longueur de la mémoire tampon de sortie, en WCHAR.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les exemples suivants peuvent vous aider. Dans ces exemples, « Filename.Ext » existe, mais « Path\that\does\not\exist » ne le fait pas.

Entrée : « C :\ClusterStorage\Volume31\Filename.Ext »
Sortie : « C :\ClusterStorage\Volume31 »
Entrée : « \\ ?\C :\ClusterStorage\Volume31\Filename.Ext »
Sortie : « \ ?\C :\ClusterStorage\Volume31 »
Entrée : « C :\ClusterStorage\Volume31\Path\that\does\not\exist »
Sortie : « C :\ClusterStorage\Volume31 »
Entrée : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\Filename.Ext »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31 »
Entrée : « \\ ?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\Filename.Ext »
Sortie : « \ ?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31 »
Entrée : « \\ ?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\Filename.Ext »
Sortie : « \ ?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31 »

Windows Server 2008 R2 : La version initiale de ResApi.h contenant la fonction ClusterGetVolumePathName utilisait des types de données TCHAR plutôt que des types de données WCHAR. La définition du préprocesseur UNICODE doit être définie avant l’inclusion de ResApi.h.

#define UNICODE 1
#include <ResApi.h>

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

Configuration requise

Condition requise	Valeur
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

Partager via