ITracing ::SetTraceLevel, méthode (wdtf.h)

Article
02/07/2025

La méthode SetTraceLevel définit le niveau de suivi d’un objet. Chaque objet du modèle objet WDTF doit prendre en charge la méthode SetTraceLevel

Syntaxe

HRESULT SetTraceLevel(
  [in] TTraceLevel Level
);

Paramètres

[in] Level

Nouvelle valeur TTraceLevel pour cet objet.

Valeur de retour

SetTraceLevel retourne une valeur de HRESULT standard.

Remarques

Pour plus d’informations sur les niveaux de suivi, consultez TTraceLevel et ITracer.

Utilisez le niveau Trace_Default pour définir l’objet sur les paramètres définis dans le Registre pour la coclasse de l’objet.

Étant donné que l’interface IAction hérite de l’interface ITracing, toutes les actions WDTF prennent en charge SetTraceLevel. Toutes les interfaces principales WDTF doivent également prendre en charge cette méthode.

L’exemple de code suivant montre comment utiliser la méthode 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."));
}

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	wdtf.h

Voir aussi

ITracer

ITracing

TTraceLevel

Partager via