GetNtmsObjectInformation 関数 (ntmsapi.h)

  • [アーティクル]

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

GetNtmsObjectInformation 関数は、指定したオブジェクトのオブジェクトの情報構造体を返します。

構文

DWORD GetNtmsObjectInformation(
  [in]  HANDLE                   hSession,
  [in]  LPNTMS_GUID              lpObjectId,
  [out] LPNTMS_OBJECTINFORMATION lpInfo
);

パラメーター

[in] hSession

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

[in] lpObjectId

RSM オブジェクトの一意識別子。

[out] lpInfo

オブジェクト情報を受け取る NTMS_OBJECTINFORMATION 構造体へのポインター。

戻り値

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

値 意味
ERROR_ACCESS_DENIED
 オブジェクトまたはそのコンテナーへのNTMS_USE_ACCESSが拒否されました。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。

Windows XP: アクセス権は必要ありません。
ERROR_INVALID_HANDLE
 セッション ハンドルがないか、無効です。
ERROR_INVALID_PARAMETER
 オブジェクト ID または情報構造体がないか、オブジェクト情報のサイズまたはオブジェクトの種類が無効です。
ERROR_NOT_ENOUGH_MEMORY
 処理中に割り当てエラーが発生しました。
ERROR_OBJECT_NOT_FOUND
 オブジェクト ID が無効です。
ERROR_SUCCESS
 関数は成功しました。

注釈

GetNtmsObjectInformation 関数を使用する前に、lpInfo パラメーターで情報構造体の情報サイズと型を正しく設定する必要があります。

予期しない結果を避けるために、アプリケーションは SetNtmsObjectInformation 関数を呼び出す前に GetNtmsObjectInformation 関数を呼び出す必要があります。 SetNtmsObjectInformation 関数は、NTMS_OBJECTINFORMATION構造体のすべての書き込み可能なメンバーを更新するため、アプリケーションは書き込み可能なすべてのメンバーに値を提供します。

特別なアクセス権を必要とするオブジェクトの一覧を次に示します。

Object Access
NTMS_CHANGER ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_CHANGER_TYPE コンピューターへのNTMS_USE_ACCESSが必要です。
NTMS_COMPUTER コンピューターへのNTMS_USE_ACCESSが必要です。
NTMS_DRIVE ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_DRIVE_TYPE コンピューターへのNTMS_USE_ACCESSが必要です。
NTMS_IEDOOR ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_IEPORT ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_LIBRARY ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_LIBREQUEST ライブラリへのNTMS_USE_ACCESSが必要です。
NTMS_LOGICAL_MEDIA 論理メディアのメディア プールへのNTMS_USE_ACCESSが必要です。
NTMS_MEDIA_TYPE コンピューターへのNTMS_USE_ACCESSが必要です。
NTMS_OPREQUEST コンピューターへのNTMS_USE_ACCESSが必要です。
NTMS_PARTITION 側のメディア プールへのNTMS_USE_ACCESSが必要です。
NTMS_PHYSICAL_MEDIA メディア プールへのNTMS_USE_ACCESSが必要です。
NTMS_STORAGESLOT ライブラリへのNTMS_USE_ACCESSが必要です。

要件

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

こちらもご覧ください

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

オブジェクト管理機能

SetNtmsObjectInformation