HrBackupGetDatabaseNames

The HrBackupGetDatabaseNames function obtains the list of attached databases on the remote computer.

Quick Info

Header file: EDBBCLI.H
Library: EDBBCLI.LIB
Unicode: Yes 

HRESULT HrBackupGetDatabaseNames(
  HBC pvBackupContext,               
  LPSTR *ppszAttachmentInformation,  
  LPDWORD pcbSize                    
);

Parameters

pvBackupContext
Input parameter. Points to the client-side context handle of the backup.
ppszAttachmentInformation
Output parameter. Points to a list of null-terminated database names as UNC paths. The list is terminated by a double-null character (\0\0).
pcbSize
Output parameter. Points to the total number of bytes returned in the buffer.

Return Values

See Return Values.

Remarks

The HrBackupGetDatabaseNames function allocates a buffer of sufficient size to hold the entire attachment list. These files need to be backed up for a full backup, but not for a differential or incremental backup. In addition, the files returned by HrBackupGetBackupLogs must be backed up for a full backup.

For more information on the HrBackupGetDataBaseNames function, see Backing Up and Restoring Data.

See Also

HrBackupGetBackupLogs