Share via


DISKSPACE( ) (Función)

Devuelve el número de bytes disponibles en la unidad de disco predeterminada.

DISKSPACE([cVolumeName [, nType]])

Valores devueltos

Numeric

Parámetros

  • cVolumeName
    Especifica el nombre de la unidad de disco o del volumen cuyo espacio disponible se va a devolver. Si se omite cVolumeName, se devolverá el espacio disponible de la unidad de disco o del volumen predeterminados.
  • nType
    Especifica el tipo de espacio de disco que se debe recuperar, de acuerdo con la tabla siguiente.
    Valor Descripción
    1 Espacio total del volumen.
    2 (Valor predeterminado) Espacio libre total del volumen.
    3 Espacio libre total disponible para el usuario asociado con el subproceso que hace la llamada.

Observaciones

Esta función es útil para determinar si hay espacio suficiente para hacer copia de seguridad de archivos o para ejecutar comandos tales como SORT que requieren espacio de disco adicional para los archivos de trabajo temporales.

La unidad de disco o el volumen predeterminados se especifican con SET DEFAULT.

DISKSPACE( ) devuelve -1 si se produce un error en la lectura de la unidad de disco o del volumen. En algunas redes, el valor devuelto por DISKSPACE( ) puede no ser exacto para las unidades de redes grandes.

Ejemplo

El ejemplo siguiente utiliza DISKSPACE( ) para determinar si hay suficiente espacio en disco disponible para ordenar.

** Check DISKSPACE before sort ** CLOSE DATABASES OPEN DATABASE (HOME(2) + 'Data\testdata') USE customer && Opens Customer table

** Get size of table header ** gnTableHead = HEADER( )

** Calculate size of table ** gnFileSize = gnTableHead + (RECSIZE( ) * RECCOUNT( ) + 1) IF DISKSPACE( ) > (gnFileSize * 3) WAIT WINDOW 'Sufficient diskspace to sort.' ELSE WAIT WINDOW 'Insufficient diskspace. Sort cannot be done.' ENDIF

Vea también

HEADER( ) | RECSIZE( ) | SET DEFAULT