SetNtmsDeviceChangeDetection 関数 (ntmsapi.h)

  • [アーティクル]

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

SetNtmsDeviceChangeDetection 関数は、変更検出用に 1 つ以上のターゲット デバイスを設定します。

構文

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

パラメーター

[in] hSession

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

[in] DetectHandle

BeginNtmsDeviceChangeDetection からのデバイス変更検出ハンドル、または単一のポーリングの場合は NULL。

[in] lpRequestId

ターゲット デバイスのオブジェクト識別子。 このパラメーターには、1 つ以上のライブラリー、メディア・タイプ、または物理メディア GUID を指定できます。 すべての GUID は同じ型である必要があります。

[in] dwType

lpObjectId パラメーターで指定されたオブジェクト識別子の型。 このパラメーターには、 NtmsObjectsTypes 列挙型の値 (NTMS_LIBRARY、NTMS_MEDIA_TYPE、またはNTMS_PHYSICAL_MEDIA) のいずれかを指定できます。

[in] dwCount

lpObjectId 内のオブジェクト識別子の数。

戻り値

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

値 意味
ERROR_INVALID_HANDLE
 セッションまたは検出ハンドルが無効です。
ERROR_INVALID_PARAMETER
 オブジェクトの種類が無効です。
ERROR_INVALID_LIBRARY
 指定したライブラリが見つかりませんでした。
ERROR_INVALID_MEDIA
 指定したメディアまたは種類が見つかりませんでした。
ERROR_SUCCESS
 オペレーター要求が取り消されました。

注釈

デバイスは、ライブラリ GUID を渡すことによって直接指定することも、物理メディアまたはメディア タイプ GUID を渡すことによって間接的に指定することもできます。 間接仕様を使用する場合は、メディアまたはメディアの種類を含むことができるすべてのスタンドアロン ライブラリが検出されます。 指定されたすべてのデバイスは、 EndNtmsDeviceChangeDetection 関数を使用してデバイス変更検出ハンドルが閉じられるまで引き続き検出されます。

この関数を使用して、指定したデバイス内の変更されたメディアをポーリングすることもできます。 これは通常、リーフ ノードを開くか、更新オプションを実装するときに UI によって使用されます。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

こちらもご覧ください

BeginNtmsDeviceChangeDetection

変更検出機能

EndNtmsDeviceChangeDetection