Compartir a través de

Función ClusterGetVolumeNameForVolumeMountPoint (resapi.h)

  • Artículo

[ClusterGetVolumeNameForVolumeMountPoint está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use GetVolumeNameForVolumeMountPoint.]

Recupera una ruta de acceso GUID de volumen de clúster para el volumen asociado al punto de montaje del volumen compartido de clúster (CSV) especificado (letra de unidad, ruta de acceso GUID del volumen o carpeta montada).

Sintaxis

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

Parámetros

[in] lpszVolumeMountPoint

Puntero a una cadena que contiene la ruta de acceso de una carpeta montada (por ejemplo, "Y:\MountX") o una letra de unidad (por ejemplo, "X:\"). La cadena debe terminar con una barra diagonal inversa final (\).

[out] lpszVolumeName

Puntero a una cadena que recibe la ruta de acceso GUID del volumen. Esta ruta de acceso tiene el formato "\?\Volume{GUID}", donde GUID es un GUID que identifica el volumen. Si hay más de una ruta de acceso GUID de volumen para el volumen, solo se devuelve la primera de la memoria caché del administrador de montaje. La cadena devuelta tiene el formato necesario para IVssBackupComponents::AddToSnapshotSet e IVssBackupComponents::IsVolumeSupported.

[in] cchBufferLength

Longitud del búfer de salida, en WCHAR. Un tamaño razonable para que el búfer admita la ruta de acceso GUID de volumen más grande posible es de 51 caracteres.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Si el ARCHIVO CSV de entrada no está montado localmente, se producirá un error de ERROR_CSV_VOLUME_NOT_LOCAL (5951).

Comentarios

Los ejemplos siguientes pueden ayudar. En estos ejemplos "Filename.Ext" existe, pero "File\that\does\not\exist" y "Directory\that\does\not\exist" no.

  • Entrada: "C:\ClusterStorage\Volume31\"

    Salida: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Entrada: "C:\ClusterStorage\Volume31\"

    Salida: la función produce un error y establece un último error de ERROR_CSV_VOLUME_NOT_LOCAL (5951).

    Nota El volumen CSV especificado para la entrada no está montado localmente para E/S directa.
     
  • Entrada: "\\?\C:\ClusterStorage\Volume31\Filename.Ext"

    Salida: la función produce un error y establece un último error de ERROR_INVALID_PARAMETER (87).

  • Entrada: "C:\ClusterStorage\Volume31\File\that\does\not\exist"

    Salida: la función produce un error y establece un último error de ERROR_INVALID_NAME (123).

  • Entrada: "C:\ClusterStorage\Volume31\Directory\that\does\not\exist\"

    Salida: la función produce un error y establece un último error de ERROR_INVALID_NAME (123).

  • Entrada: "\\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\"

    Salida: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Entrada: "\\?\Volume{de8b99bb-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\"

    Salida: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

    Nota El volumen de la salida es un CSV y es diferente del volumen del sistema que formaba parte de la entrada.
     
  • Entrada: "\\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\"

    Salida: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

  • Entrada: "\\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\"

    Salida: "\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}"

Windows Server 2008 R2: La versión inicial de ResApi.h que contiene la función ClusterGetVolumeNameForVolumeMountPoint usó tipos de datos basados en TCHAR en lugar de tipos de datos basados en WCHAR. La definición del preprocesador UNICODE debe establecerse antes de que se incluya ResApi.h. 
#define UNICODE 1
#include <ResApi.h>

Se debe llamar a la función ClusterGetVolumeNameForVolumeMountPoint desde un nodo del clúster.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter
Plataforma de destino Windows
Encabezado resapi.h
Library ResUtils.Lib
Archivo DLL ResUtils.Dll

Consulte también

Copia de seguridad y restauración de la configuración del clúster de conmutación por error mediante VSS

Funciones de copia de seguridad y restauración

GetVolumeNameForVolumeMountPoint

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::IsVolumeSupported