Método SaveExternalKeyToFile de la clase Win32_EncryptableVolume

  • Artículo

El método SaveExternalKeyToFile de la clase Win32_EncryptableVolume escribe la clave externa asociada con el protector de clave de volumen especificado en un archivo de sistema, oculto y de solo lectura en la carpeta especificada.

Este método solo es aplicable a los protectores de clave del tipo "Clave externa" o "TPM y clave de inicio".

Sintaxis

uint32 SaveExternalKeyToFile(
  [in] string VolumeKeyProtectorID,
  [in] string Path
);

Parámetros

VolumeKeyProtectorID [in]

Tipo: cadena

Identificador de cadena único que se usa para administrar un protector de clave de volumen cifrado.

Ruta de acceso [in]

Tipo: cadena

Cadena que contiene la ubicación del volumen o carpeta donde se va a guardar la clave externa asociada al protector de clave especificado. Esta ruta de acceso no incluye el nombre del archivo, que es interno y puede cambiar de versión a versión. Use GetExternalKeyFileName para obtener el nombre de archivo.

Valor devuelto

Tipo: uint32

Este método devuelve uno de los siguientes códigos u otro código de error si se produce un error.

Código o valor devuelto Descripción
S_OK
0 (0x0)
 Método realizado correctamente.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 El volumen está bloqueado.
E_INVALIDARG
2147942487 (0x80070057)
 El parámetro VolumeKeyProtectorID no hace referencia a un protector de clave del tipo "Clave externa" o "TPM y clave de inicio".
ERROR_PATH_NOT_FOUND
2147942403 (0x80070003)
 El parámetro Path no hace referencia a una ubicación válida.
Asegúrese de que el nombre de archivo no está incluido en el parámetro Path .
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker no está habilitado en el volumen. Agregue un protector de clave para habilitar BitLocker.

 

Observaciones

Los archivos de Formato de objeto administrado (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte del SDK de Windows. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF).

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista Enterprise, Windows Vista Ultimate [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 [solo aplicaciones de escritorio]
Espacio de nombres
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Consulte también

Win32_EncryptableVolume