Metodo ITracing::SetTraceLevel (wdtf.h)

Articolo
02/07/2025

Il metodo SetTraceLevel imposta il livello di traccia per un oggetto . Ogni oggetto nel modello a oggetti WDTF deve supportare il metodo setTraceLevel

Sintassi

HRESULT SetTraceLevel(
  [in] TTraceLevel Level
);

Parametri

[in] Level

Nuovo valore TTraceLevel per questo oggetto.

Valore restituito

SetTraceLevel restituisce un valore di HRESULT standard.

Osservazioni

Per altre informazioni sui livelli di traccia, vedere TTraceLevel e ITracer.

Utilizzare il livello di Trace_Default per ripristinare le impostazioni definite nel Registro di sistema per la coclasse dell'oggetto.

Poiché l'interfaccia IAction eredita dall'interfaccia ITracing, tutte le azioni WDTF supporteranno SetTraceLevel. Tutte le interfacce di base WDTF devono supportare anche questo metodo.

Nell'esempio di codice seguente viene illustrato come usare il metodo 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."));
}

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	wdtf.h

Vedere anche

ITracer

ITracing

TTraceLevel

Condividi tramite