Método IVssCreateExpressWriterMetadata::AddComponent (vswriter.h)
Agrega un grupo de archivos al conjunto de componentes de un escritor rápido al que se va a realizar una copia de seguridad.
Sintaxis
HRESULT AddComponent(
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszCaption,
[in] const BYTE *pbIcon,
[in] UINT cbIcon,
[in] bool bRestoreMetadata,
[in] bool bNotifyOnBackupComplete,
[in] bool bSelectable,
[in] bool bSelectableForRestore,
[in] DWORD dwComponentFlags
);
Parámetros
[in] ct
Valor de enumeración VSS_COMPONENT_TYPE que especifica el tipo del componente. Solo se admite VSS_CT_FILEGROUP para este parámetro.
[in] wszLogicalPath
Puntero a una cadena de caracteres anchos terminada en NULL que contiene la ruta de acceso lógica de la base de datos o el grupo de archivos. Para obtener más información, consulte Ruta de acceso lógica de componentes.
Este parámetro es opcional y puede ser NULL.
[in] wszComponentName
Puntero a una cadena de caracteres anchos terminada en null que contiene el nombre del componente. Esta cadena no está localizada.
Este parámetro es obligatorio y no puede ser NULL. La cadena no puede contener barras diagonales inversas.
[in] wszCaption
Puntero a una cadena de caracteres anchos terminada en NULL que contiene una descripción (también denominada "nombre descriptivo") para el componente. Esta cadena se puede localizar y, por lo tanto, los solicitantes deben asumir que está localizada.
Este parámetro es opcional y puede ser NULL. La cadena puede contener barras diagonales inversas.
[in] pbIcon
Puntero a un mapa de bits del icono que representa la base de datos, que se mostrará en una interfaz de usuario. El tamaño, en bytes, del búfer se especifica mediante el parámetro cbIcon .
Este parámetro es opcional y puede ser NULL.
[in] cbIcon
Tamaño del búfer en bytes. Si el parámetro pbIcon es NULL, cbIcon debe ser cero.
[in] bRestoreMetadata
Este parámetro está reservado para uso futuro y siempre debe establecerse en false.
[in] bNotifyOnBackupComplete
Este parámetro está reservado para uso futuro y siempre debe establecerse en false.
[in] bSelectable
Valor booleano que indica si el componente se puede hacer una copia de seguridad opcional (lo que significa que se puede excluir de la copia de seguridad) o siempre se hace una copia de seguridad cuando se realiza una copia de seguridad de cualquiera de los componentes del escritor. Este parámetro debe establecerse en .
True si se puede realizar una copia de seguridad selectiva del componente o false si se realiza una copia de seguridad del componente cuando se realiza una copia de seguridad de cualquiera de los componentes.
[in] bSelectableForRestore
Valor booleano que determina si un componente se puede restaurar individualmente cuando no se ha incluido explícitamente en el documento de copia de seguridad. Si el componente se agregó explícitamente al documento de copia de seguridad, siempre se puede seleccionar individualmente para la restauración; en este caso, esta marca no tiene significado.
Cuando este parámetro es true, el componente se puede restaurar por sí mismo; cuando es false, el componente solo se puede restaurar si se está restaurando todo el conjunto de componentes. (Para obtener más información, consulte VSS_COMPONENTINFO y Trabajar con la capacidad de selección y las rutas de acceso lógicas).
El valor predeterminado de este parámetro es false.
[in] dwComponentFlags
Máscara de bits de VSS_COMPONENT_FLAGS valores de enumeración que indican las características que admite este componente. Esta máscara de bits no puede incluir VSS_CF_APP_ROLLBACK_RECOVERY o VSS_CF_BACKUP_RECOVERY.
El valor predeterminado de este parámetro es cero.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Value | Significado |
|---|---|
|
La operación se realizó correctamente. |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS. |
|
El objeto es un duplicado. Ya existe un componente con la misma ruta de acceso lógica y nombre de componente. |
|
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
Se puede llamar a este método varias veces para agregar varios componentes a los metadatos de un escritor rápido.
La combinación de ruta de acceso lógica y nombre para cada componente de una instancia especificada de una clase de escritor especificada debe ser única. Al intentar llamar a AddComponent dos veces con los mismos valores de wszLogicalPath y wszComponentName , se produce un error de VSS_E_OBJECT_ALREADY_EXISTS.
AddComponent se puede usar para agregar subcomponentes: componentes en los que se realiza una copia de seguridad de todos los archivos de miembro como un grupo, pero que contienen archivos que se pueden restaurar individualmente. Para obtener más información, vea Trabajar con la capacidad de selección para restaurar y subcomponentes.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vswriter.h (incluya Vss.h, VsWriter.h) |
| Library | VssApi.lib |