Fonction ClusterGetVolumeNameForVolumeMountPoint (resapi.h)

Article
03/01/2024

[ClusterGetVolumeNameForVolumeMountPoint est disponible pour une utilisation 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 GetVolumeNameForVolumeMountPoint.]

Récupère un chemin d’accès GUID de volume de cluster pour le volume associé au point de montage du volume partagé de cluster (CSV) spécifié (lettre de lecteur, chemin GUID du volume ou dossier monté).

Syntaxe

BOOL ClusterGetVolumeNameForVolumeMountPoint(
  [in]  LPCWSTR lpszVolumeMountPoint,
  [out] LPWSTR  lpszVolumeName,
  [in]  DWORD   cchBufferLength
);

Paramètres

[in] lpszVolumeMountPoint

Pointeur vers une chaîne qui contient le chemin d’un dossier monté (par exemple, « Y :\MountX ») ou une lettre de lecteur (par exemple, « X :\ »). La chaîne doit se terminer par une barre oblique inverse de fin (\).

[out] lpszVolumeName

Pointeur vers une chaîne qui reçoit le chemin du GUID du volume. Ce chemin d’accès se présente sous la forme « \ ?\Volume{GUID} », où GUID est un GUID qui identifie le volume. S’il existe plusieurs chemins GUID de volume pour le volume, seul le premier dans le cache du gestionnaire de montage est retourné. La chaîne retournée est au format requis pour IVssBackupComponents ::AddToSnapshotSet et IVssBackupComponents ::IsVolumeSupported.

[in] cchBufferLength

Longueur de la mémoire tampon de sortie, en WCHAR. Une taille raisonnable pour la mémoire tampon afin de prendre en charge le chemin d’accès GUID de volume le plus grand possible est de 51 caractères.

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. Si le CSV d’entrée n’est pas monté localement, l’appel échoue avec une erreur ERROR_CSV_VOLUME_NOT_LOCAL (5951).

Remarques

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

Entrée : « C :\ClusterStorage\Volume31\ »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76} »
Entrée : « C :\ClusterStorage\Volume31\ »
Sortie : La fonction échoue et définit une dernière erreur de ERROR_CSV_VOLUME_NOT_LOCAL (5951).

Note Le volume CSV spécifié pour l’entrée n’est pas monté localement pour les E/S directes.
Entrée : « \\ ?\C :\ClusterStorage\Volume31\Filename.Ext »
Sortie : la fonction échoue et définit une dernière erreur de ERROR_INVALID_PARAMETER (87).
Entrée : « C :\ClusterStorage\Volume31\File\that\does\not\exist »
Sortie : la fonction échoue et définit une dernière erreur de ERROR_INVALID_NAME (123).
Entrée : « C :\ClusterStorage\Volume31\Directory\that\does\not\exist\ »
Sortie : la fonction échoue et définit une dernière erreur de ERROR_INVALID_NAME (123).
Entrée : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76} »
Entrée : « \ ?\Volume{de8b99bb-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\ »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76} »

Note Le volume dans la sortie est un CSV et est différent du volume système qui faisait partie de l’entrée.
Entrée : « \\ ?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\ »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76} »
Entrée : « \\ ?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\ »
Sortie : « \ ?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76} »

Windows Server 2008 R2 : La version initiale de ResApi.h contenant la fonction ClusterGetVolumeNameForVolumeMountPoint utilisait des types de données TCHAR au lieu 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 ClusterGetVolumeNameForVolumeMountPoint 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

GetVolumeNameForVolumeMountPoint

IVssBackupComponents ::AddToSnapshotSet

IVssBackupComponents ::IsVolumeSupported

Partager via