ITracing::SetTraceLevel-Methode (wdtf.h)

Artikel
02/07/2025

Die SetTraceLevel--Methode legt die Ablaufverfolgungsebene für ein Objekt fest. Jedes Objekt im WDTF-Objektmodell sollte die SetTraceLevel--Methode unterstützen.

Syntax

HRESULT SetTraceLevel(
  [in] TTraceLevel Level
);

Parameter

[in] Level

Der neue TTraceLevel Wert für dieses Objekt.

Rückgabewert

SetTraceLevel- gibt einen Standardwert HRESULT- zurück.

Bemerkungen

Weitere Informationen zu Ablaufverfolgungsebenen finden Sie unter TTraceLevel- und ITracer-.

Verwenden Sie die Trace_Default Ebene, um das Objekt wieder auf die Einstellungen festzulegen, die in der Registrierung für die Co-Klasse des Objekts definiert sind.

Da die IAction- Schnittstelle von der ITracing--Schnittstelle erbt, unterstützen alle WDTF-Aktionen SetTraceLevel-. Alle WDTF-Kernschnittstellen sollten diese Methode ebenfalls unterstützen.

Im folgenden Codebeispiel wird die Verwendung der SetTraceLevel--Methode veranschaulicht.

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."));
}

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	wdtf.h

Siehe auch

ITracer-

ITracing-

TTraceLevel-

Freigeben über