Share via


ISnapshotManager3

Represents a snapshot object that the client controls. The interface provides functions that enable, disables, and takes the snapshot.

Syntax

[id(1), helpstring("EnablePeriodicSnapshot")] HRESULT EnablePeriodicSnapshot([in] SnapshotType snapshotType, [in] ULONG interval, [in] ULONG* pids, [in] ULONG cPids);
[id(2), helpstring("DisablePeriodicSnapshot")] HRESULT DisablePeriodicSnapshot([in] SnapshotType snapshotType);
[id(3), helpstring("SnapshotOnDemand")] HRESULT SnapshotOnDemand([in] SnapshotType snapshotType, [in] ULONG* pids, [in] ULONG cPids);
[id(4), helpstring("VerifySnapshotSupported")] HRESULT VerifySnapshotSupported([in] TRACEHANDLE traceHandle, [in, out] ULONG* frequencyInSeconds, [in, out] ULONG* cProviders);
[id(5), helpstring("ConfigSnapshotByPID")] HRESULT ConfigSnapshotByPID([in] ULONG* pids, [in] ULONG cPids, [in] VARIANT_BOOL fEnable);
[id(6), helpstring("ConfigSnapshotByProcess")] HRESULT ConfigSnapshotByProcess([in] BSTR bstrProcName, [in] VARIANT_BOOL fEnable);
[id(7), helpstring("ConfigSnapshotByPIDEx")] HRESULT ConfigSnapshotByPIDEx([in] SnapshotType snapshotType, [in] ULONG* pids, [in, out] HRESULT* pResults, [in] ULONG cPids, [in] VARIANT_BOOL fEnable);
[id(8), helpstring("ConfigSnapshotByProcessEx")] HRESULT ConfigSnapshotByProcessEx([in] SnapshotType snapshotType, [in] BSTR bstrProcName, [in] VARIANT_BOOL fEnable);

Functions

The following table describes the functions that this interface provides.

Function Description
ConfigSnapshotByPID Configures snapshot using the provided process id.
ConfigSnapshotByPIDEx Configures snapshot using the provided process id.
ConfigSnapshotByProcess Configures snapshot using the provided process name.
ConfigSnapshotByProcessEx Configures snapshot using the provided process name.
DisablePeriodicSnapshot Disables periodic snapshot.
EnablePeriodicSnapshot Enables periodic snapshot with the given interval.
SnapshotOnDemand Takes snapshot of Snapshot type and exports to the trace buffers.
VerifySnapshotSupported Queries periodic capture state limits.

Remarks

Most functions require administrator privileges.