Método IVssSoftwareSnapshotProvider::GetSnapshotProperties (vsprov.h)

Obtiene las propiedades de la instantánea especificada.

Sintaxis

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Parámetros

[in] SnapshotId

Identificador de instantánea.

[out] pProp

Dirección de una estructura de VSS_SNAPSHOT_PROP asignada por el autor de la llamada que recibe las propiedades de instantánea. El proveedor es responsable de establecer los miembros de esta estructura. Todos los miembros son necesarios excepto m_pwszExposedName y m_pwszExposedPath, que el proveedor puede establecer en NULL. El proveedor asigna memoria para todos los miembros de cadena que establece en la estructura. Cuando la estructura ya no es necesaria, el autor de la llamada es responsable de liberar estas cadenas mediante una llamada a la función VssFreeSnapshotProperties .

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor	Significado
S_OK	La información solicitada se devolvió correctamente.
E_ACCESSDENIED	El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
E_INVALIDARG	Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY	El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_OBJECT_NOT_FOUND	No se encontró el volumen especificado.
VSS_E_PROVIDER_VETO	Error del proveedor. El proveedor registró el error en el registro de eventos. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_UNEXPECTED	error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS. Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

El llamador debe establecer el contenido de la estructura de VSS_SNAPSHOT_PROP en cero antes de llamar al método GetSnapshotProperties .

El proveedor es responsable de asignar y liberar las cadenas en la estructura VSS_SNAPSHOT_PROP .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vsprov.h
Library	VssApi.lib

Consulte también

IVssSoftwareSnapshotProvider

VssFreeSnapshotProperties