Compartir a través de

Función ClusterGetVolumePathName (resapi.h)

  • Artículo

[ClusterGetVolumePathName 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 GetVolumePathName.]

Recupera el punto de montaje de volumen en el clúster donde se monta la ruta de acceso especificada.

Sintaxis

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

Parámetros

[in] lpszFileName

Puntero a la cadena de ruta de acceso de entrada. Los nombres de archivo y directorio absolutos y relativos, por ejemplo "..", son aceptables en esta ruta de acceso.

Si especifica un nombre de archivo o directorio relativo sin un calificador de volumen, ClusterGetVolumePathName devuelve la letra de unidad del volumen actual.

Si este parámetro es una cadena vacía, "", se produce un error en la función, pero el último error se establece en ERROR_SUCCESS.

[out] lpszVolumePathName

Puntero a una cadena que recibe el punto de montaje del volumen para la ruta de acceso de entrada.

[in] cchBufferLength

Longitud del búfer de salida, en WCHAR.

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.

Comentarios

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

  • Entrada: "C:\ClusterStorage\Volume31\Filename.Ext"

    Salida: "C:\ClusterStorage\Volume31"

  • Entrada: "\\?\C:\ClusterStorage\Volume31\Filename.Ext"

    Salida: "\?\C:\ClusterStorage\Volume31"

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

    Salida: "C:\ClusterStorage\Volume31"

  • Entrada: "\\?\Volume{deadbeef-895e-4a1d-9d64-9b82fa068d76}\ClusterStorage\Volume31\Filename.Ext"

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

  • Entrada: "\\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31\Filename.Ext"

    Salida: "\?\GLOBALROOT\Device\Harddisk0\Partition1\ClusterStorage\Volume31"

  • Entrada: "\\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31\Filename.Ext"

    Salida: "\?\GLOBALROOT\Device\HarddiskVolume1\ClusterStorage\Volume31"

Windows Server 2008 R2: La versión inicial de ResApi.h que contiene la función ClusterGetVolumePathName 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 ClusterGetVolumePathName 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