ITracing::SetTraceLevel メソッド (wdtf.h)

SetTraceLevel メソッドは、オブジェクトのトレース レベルを設定します。 WDTF オブジェクト モデル内のすべてのオブジェクトは 、SetTraceLevel メソッドをサポートする必要があります

構文

HRESULT SetTraceLevel(
  [in] TTraceLevel Level
);

パラメーター

[in] Level

このオブジェクトの新しい TTraceLevel 値。

戻り値

SetTraceLevel は 、標準の HRESULT 値を返します。

注釈

トレース レベルの詳細については、「 TTraceLevel と ITracer」を参照してください。

Trace_Default レベルを使用して、オブジェクトの共同クラスのレジストリで定義されている設定にオブジェクトを戻します。

IAction インターフェイスはITracing インターフェイスから継承されるため、すべての WDTF アクションで SetTraceLevel がサポートされます。 すべての WDTF コア インターフェイスでも、このメソッドをサポートする必要があります。

次のコード例は、 SetTraceLevel メソッドの使用方法を示しています。

[VBScript]

'
' Get DeviceManagement Action interface for the target
'
Set Action = CDROM.GetInterface("DeviceManagement")
 
If Err.number <> 0 Then
    WScript.Echo Space(4) & "Failed to get interface DeviceManagement. Error Number:" & Err.number
Else            
    '
    ' Set the tracing level to HIGH
    '
    Action.SetTraceLevel(Trace3_High)
    If Err.number <> 0 Then
        WScript.Echo Space(4) & "Failed to set tracing level to 'High'. Error Number:" & Err.number
    End If

    '
    ' Disable the CD-ROM
    '
    WScript.Echo Space(4) & "Trying to disable device..."
 
    Action.Disable()
 
    If Err.number <> 0 Then
        WScript.Echo Space(4) & "Failed to disable the specified CDROM. Error     Number:" & Err.number & vbcrlf
    Else
        WScript.Echo Space(4) & "Specified CDROM successfully disabled." & vbcrlf
    End If
End If

C++

IDevMan* pDevMan;        // DeviceManagement Action interface

VARIANT vtEmpty;       // To be passed as a parameter to ITarget::GetInterface
VariantInit(&vtEmpty);

//
// Get DeviceManagement Action interface
//
hr = pCDROM->GetInterface(L"DeviceManagement", vtEmpty, vtEmpty, (IAction**)(&pDevMan));
if(FAILED(hr))
{
    _tprintf(_T("\n  Failed to get DeviceManagement Interface for specified CDROM Device. Error: 0x%x"), hr);
 goto Cleanup;
}

//
// Set the trace level to High
//
hr = pDevMan->SetTraceLevel(Trace3_High);
if(FAILED(hr))
{
    _tprintf(_T("\n  Failed to set tracing level to 'High'. Error: 0x%x"), hr);
}
 
//
// Disable the CD-ROM
//
_tprintf(_T("\n  Trying to disable device..."));

hr = pDevMan->Disable();
if(FAILED(hr))
{
    _tprintf(_T("\n  Failed to disable the specified CDROM. Error: 0x%x"), hr);
}
else
{
    _tprintf(_T("\n  Specified CDROM successfully disabled."));
}

要件

要件	値
対象プラットフォーム	デスクトップ
Header	wdtf.h

こちらもご覧ください

ITracer

ITracing

TTraceLevel