[This function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Beginning with Windows Vista, use Volume Shadow Copy Service (VSS) instead.]
The DsBackupClose function closes a backup file opened with the DsBackupOpenFile function. For each backup handle, only one file can be opened at a time, so this function closes the currently open file.
Syntax
HRESULT DsBackupClose(
_In_ HBC hbc
);
Parameters
hbc [in]
Contains the backup context handle obtained with the DsBackupPrepare function.
Return value
Returns S_OK if the function is successful or a Win32 or RPC error code otherwise. The following list lists other possible error codes.
ERROR_INVALID_PARAMETER
hbc is not valid.
hrInvalidHandle
No file is currently open.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Header | Ntdsbcli.h |
| Library | Ntdsbcli.lib |
| DLL | Ntdsbcli.dll |
See also
Backing Up an Active Directory Server
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
