Método IVssFileShareSnapshotProvider::GetSnapshotProperties (vsprov.h)
Obtiene la estructura VSS_SNAPSHOT_PROP de una instantánea de recurso compartido de archivos.
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 |
|---|---|
|
La información solicitada se devolvió correctamente. |
|
El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es un administrador. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
No se encontró el volumen especificado. |
|
Error del proveedor. El proveedor registró el error en el registro de eventos. Para obtener más información, vea Control de eventos y errores en VSS. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, vea Control de eventos y errores en VSS. |
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 .
El coordinador de VSS llama a este método durante la fase postSnapshot de creación de instantáneas con el fin de recuperar la ruta de acceso a la instantánea (ruta de acceso UNC para las instantáneas del recurso compartido de archivos). El coordinador llama a este método después de PreFinalCommitSnapshots y antes de invocar PostSnapshot en los escritores.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8.1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsprov.h |
| Library | VssApi.lib |