Método ITracing::SetTraceLevel (wdtf.h)

O método SetTraceLevel define o nível de rastreamento de um objeto . Cada objeto no modelo de objeto WDTF deve dar suporte ao método SetTraceLevel

Sintaxe

HRESULT SetTraceLevel(
  [in] TTraceLevel Level
);

Parâmetros

[in] Level

O novo valor de TTraceLevel para esse objeto.

Retornar valor

SetTraceLevel retorna um valor HRESULT padrão.

Comentários

Para obter mais informações sobre níveis de rastreamento, consulte TTraceLevel e ITracer.

Use o nível de Trace_Default para definir o objeto de volta para as configurações definidas no registro para a coclasse do objeto.

Como a interface IAction herda da interface ITracing , todas as Ações do WDTF darão suporte a SetTraceLevel. Todas as interfaces principais do WDTF também devem dar suporte a esse método.

O exemplo de código a seguir demonstra como usar o método 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."));
}

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdtf.h

Confira também

ITracer

ITracing

TTraceLevel