次の方法で共有

SetNtmsObjectInformationA 関数 (ntmsapi.h)

  • [アーティクル]

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

SetNtmsObjectInformation 関数は、指定したオブジェクトの情報構造を変更します。

構文

DWORD SetNtmsObjectInformationA(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONA lpInfo
);

パラメーター

[in] hSession

OpenNtmsSession 関数によって返されるセッションへのハンドル。

[in] lpObjectId

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

[in] lpInfo

NTMS_OBJECTINFORMATION 構造体へのポインター。

戻り値

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

価値 意味
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESSまたはNTMS_CONTROL_ACCESSが書き込まれるオブジェクトに対して拒否されるか、指定されたオブジェクトの種類に対する変更は許可されません。 「解説」を参照してください。
ERROR_SUCCESS
 関数が成功しました。
ERROR_DATABASE_FAILURE
 データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL
 データベースがいっぱいです。
ERROR_INVALID_HANDLE
 セッション ハンドルが見つからないか、無効です。
ERROR_INVALID_PARAMETER
 オブジェクト ID または情報構造がないか、オブジェクト情報のサイズまたはオブジェクトの種類が無効です。
ERROR_NOT_ENOUGH_MEMORY
 処理中に割り当てエラーが発生しました。
ERROR_OBJECT_NOT_FOUND
 オブジェクト ID が無効です。

備考

SetNtmsObjectInformationを使用するには、情報のサイズと種類 設定する必要があります。

オブジェクトのすべての書き込み可能なプロパティは、NTMS_OBJECTINFORMATION 構造体から読み取られ、このアプリケーションが GetNtmsObjectInformation 関数と SetNtmsObjectInformation 関数と呼ばれるまでの間に発生した書き込み操作に関係なくデータベースに書き込まれます。 このため、変更が失われる可能性があります。

予期しない結果を回避するには、アプリケーションで GetNtmsObjectInformation 呼び出してから、SetNtmsObjectInformation呼び出す必要があります。 前述のように、SetNtmsObjectInformation は、すべての書き込み可能なメンバーを更新するため、アプリケーションはすべての書き込み可能なメンバーに値を提供する必要があります。

更新可能なメンバーを持つオブジェクトの一覧を次に示します。

オブジェクト メンバーズ
NTMS_CHANGER szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_CHANGER_TYPE szDescription コンピューターへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_COMPUTER dwMediaPoolPolicy を する
 
dwLibRequestFlags を する
 
dwLibRequestPurgeTime を する
 
dwOpRequestFlags を する
 
dwOpRequestPurgeTime を する
 
szDescription コンピューターへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_DRIVE dwDeferDismountDelay の
 
szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_DRIVE_TYPE szDescription コンピューターへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_IEDOOR MaxOpenSecs の
 
szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_IEPORT MaxExtendSecs の
 
szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_LIBRARY 自動回復 の
 
dwCleanerUsesRemaining の
 
dwFlags を する
 
InventoryMethod
 
szDescription
 
szName ライブラリへのNTMS_CONTROL_ACCESSが必要です。
NTMS_LIBREQUEST szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_LOGICAL_MEDIA szDescription
 
szName 論理メディアのメディア プールへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates を する
 
MediaType
 
szDescription
 
szName メディア プールへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: メディア プールへのNTMS_CONTROL_ACCESSが必要です。
NTMS_MEDIA_TYPE szDescription コンピューターへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_OPREQUEST szDescription コンピューターへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_PARTITION szName
 
szDescription サイドのメディア プールへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: サイドのメディア プールにNTMS_CONTROL_ACCESSが必要です。
NTMS_PHYSICAL_MEDIA szDescription
 
szName メディア プールへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
NTMS_STORAGESLOT szDescription ライブラリへのNTMS_MODIFY_ACCESSが必要です。

Windows XP: アクセス権は必要ありません。
 

手記

ntmsapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして SetNtmsObjectInformation を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ntmsapi.h
ライブラリ Ntmsapi.lib
DLL Ntmsapi.dll

関連項目

GetNtmsObjectInformation の

GetNtmsObjectSecurity の

NTMS_OBJECTINFORMATION

オブジェクト管理機能の