DsBackupRead 関数
[この関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それより後のバージョンでは、変更されるか、使用できなくなる場合があります。 Windows Vista 以降では、代わりにボリューム シャドウ コピー サービス (VSS) を使用します。
DsBackupRead 関数は、現在開いているファイルからバッファーにデータ ブロックを読み取ります。 クライアント アプリケーションは、バックアップ ファイル全体が受信されるまで、この関数を繰り返し呼び出す必要があります。 DsBackupOpenFile 関数は、バックアップ ファイルのサイズ全体を提供します。
構文
HRESULT DsBackupRead(
_In_ HBC hbc,
_In_ PVOID pvBuffer,
_In_ DWORD cbBuffer,
_Out_ PDWORD pcbRead
);
パラメーター
-
hbc [in]
-
DsBackupPrepare 関数で取得した バックアップ コンテキスト ハンドルを 格納します。
-
pvBuffer [in]
-
データを受け取るバッファーへのポインター。 このバッファーのサイズは、cbBuffer バイト以上である必要があります。
-
cbBuffer [in]
-
pvBuffer のバッファーのサイズをバイト単位で格納します。 この値は 8192 の倍数で、24576 以上である必要があります。
-
pcbRead [out]
-
読み取られた実際の バイト数を受け取る DWORD 値へのポインター。 一部のトランスポートは、バッファー全体にデータを格納するのではなく、送信されるバッファーをフラグメント化するため、要求されたバイト数よりも小さい場合があります。
戻り値
関数が 成功した場合はS_OK を返し、それ以外の場合は Win32 または RPC エラー コードを返します。 考えられるエラー コードは次のとおりです。
-
ERROR_INVALID_PARAMETER
-
1 つ以上のパラメーターが無効です。
-
ERROR_HANDLE_EOF
-
バックアップ ファイルの末尾に達しました。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|