DsBackupGetBackupLogs 関数
[この関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それより後のバージョンでは、変更されるか、使用できなくなる場合があります。 Windows Vista 以降では、代わりにボリューム シャドウ コピー サービス (VSS) を使用します。
DsBackupGetBackupLogs 関数は 、 特定のバックアップ コンテキストに対してバックアップする必要があるログ ファイルの一覧を取得します。
構文
HRESULT DsBackupGetBackupLogs(
_In_ HBC hbc,
_Out_ LPTSTR *pszBackupLogFiles,
_Out_ LPDWORD pcbSize
);
パラメーター
-
hbc [in]
-
DsBackupPrepare 関数で取得した バックアップ コンテキスト ハンドルを 格納します。
-
pszBackupLogFiles [out]
-
UNC パスとしてログ ファイル名の一覧を受け取る文字列ポインターへのポインター。 DsBackupGetBackupLogs を呼び出す前に、この値を NULL に初期化します。
このリストは、1 つの null で終わる文字列の null で終わる 2 つのリストを受け取ります。
このバッファーは DsBackupGetBackupLogs 関数によって割り当てられ、DsBackupFree 関数を呼び出して不要になったときに解放する必要があります。
各ファイル名の最初の文字には、名前の種類を 識別する BFT 定数 のいずれかが含まれています。
-
pcbSize [out]
-
pszBackupLogFiles バッファーのサイズ (バイト単位) を受け取る DWORD 値へのポインター。
戻り値
関数が 成功した場合はS_OK を返し、それ以外の場合は Win32 または RPC エラー コードを返します。 次の一覧に、考えられるその他のエラー コードを示します。
-
ERROR_ACCESS_DENIED
-
呼び出し元には、この関数を呼び出す適切なアクセス特権がありません。 DsSetAuthIdentity 関数を使用して、バックアップおよび復元関数に使用する資格情報を設定できます。
-
ERROR_INVALID_PARAMETER
-
hbc、 pszBackupLogFiles、または pcbSize が無効です。
-
ERROR_NOT_ENOUGH_MEMORY
-
メモリ割り当てエラーが発生しました。
解説
DsBackupGetBackupLogs 関数は、バックアップに必要なログ ファイルの一覧を提供します。 完全バックアップは、DsBackupGetDatabaseNames 関数によって提供されるデータベース ファイルとログ ファイルで構成されます。 Active Directory サーバーの増分バックアップはサポートされていません。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
DsBackupGetBackupLogsW (Unicode) と DsBackupGetBackupLogsA (ANSI) |