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