OpenTraceFromRealTimeLogger 函式 (evntrace.h)

建立附加至作用中即時 ETW 工作階段的追蹤處理工作階段。

語法

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

參數

LoggerName

從記錄檔處理數據時，即時事件追蹤會話的名稱，或 NULL 。 如果您要呼叫 OpenTraceFromRealTimeLogger 以取用即時會話中的數據，請指定此成員的值。

呼叫 OpenTraceFromRealTimeLogger 時，如果 LogFileHeader 不是 NULL ， 則 LoggerName 必須是 NULL。

如果追蹤控制器已設定 EVENT_TRACE_PROPERTIES 的 LogFileMode 成員以包含EVENT_TRACE_REAL_TIME_MODE旗標，您只能即時取用事件。

只有具有系統管理許可權、效能記錄使用者群組中的使用者，以及以LocalSystem、LocalService、NetworkService 執行的應用程式，才能即時取用事件。 若要授與受限制的用戶即時取用事件的能力，請將事件新增至 Performance Log Users 群組或呼叫 EventAccessControl。

Options

此處理工作階段的組態選項。 如需詳細資訊 ，請參閱ETW_OPEN_TRACE_OPTIONS 。

LogFileHeader

記錄檔的標頭資訊。 如需詳細資訊 ，請參閱TRACE_LOGFILE_HEADER 。

傳回值

用來識別此處理會話的 TRACEHANDLE。 通常傳遞至 ProcessTrace 以開始處理，並將 CloseTrace 傳遞給結束處理。

備註

在傳回的 TRACEHANDLE 上呼叫 ProcessTrace 之後，這會從 ETW 會話接收緩衝區，因為它們已排清，並立即開始處理它們，並呼叫 Options 中指定的回呼。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	evntrace.h
程式庫	Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.lib;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.lib
Dll	Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.dll;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll