CancelNtmsLibraryRequest 関数 (ntmsapi.h)

[リムーバブル記憶域マネージャーは、Windows 7 および Windows Server 2008 R2 以降では使用できません。

CancelNtmsLibraryRequest 関数は、CleanNtmsDrive 関数の呼び出しなど、未処理の RSM 要求を取り消します。ライブラリがビジー状態の場合、RSM はキャンセルをキューに入れ、成功を返します。

構文

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

[in] hSession

OpenNtmsSession 関数によって返されるセッションを処理します。

[in] lpRequestId

取り消すライブラリ要求の一意識別子。

既存のライブラリ要求の一覧を取得するには、 EnumerateNtmsObject 関数を使用します。

この関数は、次のいずれかの値を返します。

値	意味
ERROR_ACCESS_DENIED	RSM サーバーの管理者のみがライブラリ要求を取り消すことができます。このエラーは、要求が現在処理されており、削除できない場合にも返されます。
ERROR_INVALID_HANDLE	セッションハンドルがないか、無効です。
ERROR_NOT_ENOUGH_MEMORY	処理中に割り当てエラーが発生しました。
ERROR_OBJECT_NOT_FOUND	ライブラリ要求オブジェクト ID が見つかりませんでした。このエラーは、キャンセルを発行する前に要求が完了した場合、または無効な要求 ID が指定されている場合に発生します。
ERROR_SUCCESS	取り消しのためにライブラリ要求がキューに入れられます。