DsRestorePrepare 関数
[この関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それより後のバージョンでは、変更されるか、使用できなくなる場合があります。 Windows Vista 以降では、代わりにボリューム シャドウ コピー サービス (VSS) を使用します。
DsRestorePrepare 関数は、指定されたディレクトリ サーバーに接続し、復元操作用に準備します。
構文
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
パラメーター
-
szServerName [in]
-
復元するサーバーの名前を含む null で終わる文字列へのポインター。 前の円記号は省略可能です。 サーバーは、この関数が呼び出されるコンピューターと同じである必要があります。 サーバー名にアンダースコア (_) 文字を含めることはできません。 サーバー名の例として、"\\server1" があります。
-
rtFlag [in]
-
実行する復元の種類を指定します。 0 または次のいずれかの値を指定できます。
-
RESTORE_TYPE_CATCHUP
-
既定。 復元されたバージョンは、復元された DIT が他のエンタープライズ サーバー コンピューターと同期できるように、標準の調整ロジックによって調整されます。
-
RESTORE_TYPE_AUTHORATATIVE
-
サポートされていない。
-
RESTORE_TYPE_ONLINE
-
サポートされていない。 復元は、NTDS がオンラインのときに実行されます。
pvExpiryToken [in]
復元されるバックアップに関連付けられている有効期限トークンへのポインター。 このトークンは、ディレクトリのバックアップ時に DsBackupPrepare 関数から取得されました。
このパラメーターが NULL の場合、phbc で返されるハンドルは、DsRestoreGetDatabaseLocations 関数を使用して復元ディレクトリを取得するためにのみ使用できます。 ハンドルは、他の復元関数には使用できません。
cbExpiryTokenSize [in]
pvExpiryToken の有効期限トークンのサイズをバイト単位で格納します。
phbc [out]
復元のハンドルを 受け取る HBC 値へのポインター。 このハンドルは、DsBackupOpenFile や DsRestoreEnd などの他のディレクトリ サービス復元関数を呼び出すときに使用されます。
戻り値
成功した場合は、標準 の HRESULT コードが返されます。それ以外の場合は、エラー コードが返されます。
解説
DsRestorePrepare 関数では、呼び出し元がサーバー上の 管理istrators グループのメンバーである必要があります。
DsRestorePrepare は、トークンが指定されている場合と指定されていない場合に使用できます。 トークンが指定されている場合、トークンは有効期限のためにチェックされ、返されたコンテキストですべての操作が許可されます。 トークンが指定されていない場合、返されるコンテキストは制限され、DsRestoreGetDatabaseLocations 関数にのみ使用できます。 DsRestoreRegister 関数には使用できません。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
DsRestorePrepareW (Unicode) と DsRestorePrepareA (ANSI) |