Método IPreviousVersionsInfo::AreSnapshotsAvailable (shobjidl.h)

Consulta la disponibilidad de una imagen de volumen de Windows Server 2003 registrada por el sistema en un momento anterior.

Sintaxis

HRESULT AreSnapshotsAvailable(
  [in]  LPCWSTR pszPath,
  [in]  BOOL    fOkToBeSlow,
  [out] BOOL    *pfAvailable
);

Parámetros

[in] pszPath

Tipo: LPCWSTR

Cadena Unicode terminada en null que contiene la ruta de acceso completa a un archivo o carpeta del volumen en cuestión.

Nota Actualmente solo se admiten rutas de acceso a archivos y carpetas almacenados en un volumen de Windows Server 2003.

 

[in] fOkToBeSlow

Tipo: BOOL

Valor booleano que especifica si se debe ponerse en contacto con un servidor para determinar la disponibilidad de las imágenes de volumen almacenadas. Para obtener más información, vea la sección Comentarios.

TRUE

Póngase en contacto con el servidor si los resultados aún no están almacenados en caché.

FALSE

No póngase en contacto con el servidor. En su lugar, use los resultados almacenados en caché.

[out] pfAvailable

Tipo: BOOL*

Puntero a una variable booleana que contiene el resultado. Este valor solo es válido si la llamada al método se realiza correctamente; de lo contrario, no está definido.

TRUE

Al menos una imagen almacenada del volumen donde reside el archivo o carpeta denominado en pszPath está disponible.

FALSE

No se almacenan imágenes de volumen.

Valor devuelto

Tipo: HRESULT

Devuelve valores de error estándar, incluidos, entre otros, los siguientes:

Código devuelto	Descripción
S_OK	Correcto.
E_PENDING	fOkToBeSlow es FALSE y el resultado no se almacena actualmente en caché.

Comentarios

Si se llama a IPreviousVersionsInfo::AreSnapshotsAvailable en un archivo o carpeta, el resultado no indica que la información de reversión está disponible para ese archivo o carpeta específicos, simplemente que hay disponible una instantánea de todo el volumen. Este resultado se almacena en caché y las llamadas subsiguientes preguntan sobre cualquier cosa almacenada en ese mismo volumen que tengan acceso a los resultados almacenados en caché, con poca sobrecarga de rendimiento, en lugar de volver a conectar el servidor.

Una vez que la respuesta del servidor se almacena en caché en la memoria, las llamadas posteriores no se pone en contacto con el servidor aunque fOkToBeSlow sea TRUE. Si fOkToBeSlow es FALSE y la respuesta del servidor aún no se almacena en caché desde una llamada anterior, el método devuelve E_PENDING. En ese caso, establezca fOkToBeSlow enTRUE y llame a IPreviousVersionsInfo::AreSnapshotsAvailable de nuevo para ponerse en contacto con el servidor.

Para mejorar el rendimiento, un subproceso de interfaz de usuario que llama a este método siempre debe establecer fOkToBeSlow en FALSE. Si el método devuelve E_PENDING, siga estos pasos.

• Cree otra instancia de IPreviousVersionsInfo en un subproceso en segundo plano.
• Llame a IPreviousVersionsInfo::AreSnapshotsAvailable con fOkToBeSlow establecido en TRUE.
• Señale el subproceso de interfaz de usuario original para llamar a IPreviousVersionsInfo::AreSnapshotsAvailable de nuevo. A continuación, los resultados se extraen de la memoria caché.

Requisitos

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	shobjidl.h
Archivo DLL	Twext.dll (versión 5.2 o posterior)