注: このメソッドの使用は現在推奨されていません 代わりに このメソッドが提供する機能と完全に重複する より一般的な RequestStateChange メソッドを使用します 従来の説明: LogicalDevice をオンライン (\"オンライン\" ...

注: このメソッドの使用は現在推奨されていません。代わりに、このメソッドが提供する機能と完全に重複する、より一般的な RequestStateChange メソッドを使用します。
従来の説明: LogicalDevice をオンライン (\"オンライン\" 入力パラメーターが TRUE) またはオフライン (FALSE) にするよう要求します。\"オンライン\" はデバイスが要求を受け付ける準備ができており、操作可能で完全に機能していることを示します。この場合、デバイスの Availability プロパティは、3 (\"実行中/通常の電力\") に設定されます。\"オフライン\" は、デバイスの電源がオンで操作可能ですが、機能要求の処理は行っていないことを示します。オフライン状態では、デバイスは診断の実行や操作警告の生成を行うことができます。たとえば、プリンターで \"オフライン\" ボタンが押された場合、デバイスは印刷ジョブを処理することはできませんが、診断や保守を行うことはできます。
このメソッドが成功した場合、デバイスの Availability プロパティおよび AdditionalAvailability プロパティは、更新された状態を反映します。デバイスをオンラインまたはオフラインにするときに障害が発生した場合は、現在の状態を維持します。つまり、要求が失敗した場合、デバイスは中間状態になりません。デバイスを \"オフライン\" モードから \"オンライン\" に戻すときは、デバイスは可能な限り最新の \"オンライン\" 状態に復元されます。EnabledState/StatusInfo が \"有効\" であり構成済みのデバイスのみ、オンラインまたはオフラインにすることができます。
OnlineDevice は、成功した場合は 0 を、要求がサポートされていない場合は 1 を、現在のデバイスの状態が原因で要求がサポートされない場合は 2 を、その他のエラーが発生した場合は別の値を返します。サブクラスでは、使用可能なリターン コード セットを、メソッドの ValueMap 修飾子を使用して指定することができます。ValueMap の内容を '変換' した文字列も、Values 配列修飾子としてサブクラスで指定できます。
このメソッドの機能は、RequestedState プロパティの機能と重複しています。RequestedState は、最新の状態要求に関するレコード (持続的な値など) を維持するため、モデルに追加されました。OnlineDevice メソッドの呼び出しで、RequestedState プロパティが適切に設定されます。