SetNtmsMediaComplete 関数 (ntmsapi.h)
[リムーバブル 記憶域マネージャー は、Windows 7 および Windows Server 2008 R2 以降では使用できません。
SetNtmsMediaComplete 関数は、論理メディアの一部を完全としてマークします。
構文
DWORD SetNtmsMediaComplete(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpMediaId
);
パラメーター
[in] hSession
OpenNtmsSession 関数によって返されるセッションを処理します。
[in] lpMediaId
論理メディアの一意識別子。
戻り値
この関数は、次のいずれかの値を返します。
| 値 | 意味 |
|---|---|
|
メディアのメディア プールへのNTMS_CONTROL_ACCESSは拒否されます。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。
Windows XP: メディアのメディア プールへのNTMS_MODIFY_ACCESSは拒否されます。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。 |
|
データベースにアクセスできないか、破損しています。 |
|
データベースがいっぱいです。 |
|
セッション ハンドルがないか、無効です。 |
|
メディア識別子が無効です。 |
|
メディアのメディア プールが無効です。 |
|
メディア識別子がありません。 |
|
メディアが割り当てられた状態ではないか、現在マウントされています。 |
|
処理中に割り当てエラーが発生しました。 |
|
関数は成功しました。 |
注釈
SetNtmsMediaComplete 関数は、指定されたメディアを Complete としてマークします。 アプリケーションがメディアに書き込む予定がなくなった場合、アプリケーションはメディアを Complete としてマークします。 NTMS_MOUNT_WRITE フラグを使用して完全なメディアをマウントすることはできません。
SetNtmsMediaComplete 関数は、通常、アプリケーションがメディアの末尾に達したときに使用されます。 マウントされているメディアまたは使用中のメディアは、完了としてマークできません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntmsapi.h |
| Library | Ntmsapi.lib |
| [DLL] | Ntmsapi.dll |