Compartir a través de

Función SHFormatDrive (shlobj_core.h)

  • Artículo

[SHFormatDrive está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Abre el cuadro de diálogo Formato del shell.

Sintaxis

DWORD SHFormatDrive(
  [in] HWND hwnd,
       UINT drive,
       UINT fmtID,
       UINT options
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana primaria del cuadro de diálogo. El cuadro de diálogo Formato debe tener una ventana primaria; por lo tanto, este parámetro no puede ser NULL.

drive

Tipo: UINT

Unidad a la que se va a dar formato. El valor de este parámetro representa una unidad de letra a partir de 0 para la unidad A: . Por ejemplo, un valor de 2 significa la unidad C: .

fmtID

Tipo: UINT

Identificador del formato físico. Actualmente solo se define la marca siguiente.

SHFMT_ID_DEFAULT (0xFFFF)

Identificador de formato predeterminado.

options

Tipo: UINT

Este valor debe ser 0 o uno de los valores siguientes que modifican las opciones de formato predeterminadas en el cuadro de diálogo. Este valor se considera un campo de bits y debe tratarse en consecuencia.

SHFMT_OPT_FULL (0x0001)

0x001. Si se establece esta marca, se selecciona la opción Formato rápido .

Esta función se incluye en Shlobj.h solo en Windows XP con SP1 y versiones posteriores.

Windows XP: Antes de Windows XP con SP1, esta función es accesible a través de Shell32.lib.

SHFMT_OPT_SYSONLY (0x0002)

0x002. Selecciona la opción Crear un disco de inicio de MS-DOS , creando un disco de arranque del sistema.

Valor devuelto

Tipo: DWORD

Devuelve el identificador de formato del último formato correcto o uno de los valores siguientes. El LOWORD de este valor se puede pasar en llamadas posteriores como parámetro fmtID para repetir el último formato.

Código devuelto Descripción
SHFMT_ERROR
 Error durante el último formato. Esto no indica que la unidad no esformatable.
SHFMT_CANCEL
 Se canceló el último formato.
SHFMT_NOFORMAT
 No se puede dar formato a la unidad.

Comentarios

El formato se controla mediante la interfaz del cuadro de diálogo. Es decir, el usuario debe hacer clic en el botón Aceptar para comenzar realmente el formato; el formato no se puede iniciar mediante programación.

Ejemplos

Esta llamada a SHFormatDrive abre el cuadro de diálogo Formato del shell para un disco de la unidad A, con las opciones de formato predeterminadas seleccionadas.

SHFormatDrive(hMainWnd, 0, SHFMT_ID_DEFAULT, 0);

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)