共用方式為

EvtGetQueryInfo 函式 (winevt.h)

  • 發行項

取得您所執行之查詢的相關信息，該查詢會識別查詢嘗試存取的通道或記錄檔清單。 函式也會取得傳回碼清單，指出每個存取的成功或失敗。

語法

BOOL EvtGetQueryInfo(
  [in]  EVT_HANDLE            QueryOrSubscription,
  [in]  EVT_QUERY_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

參數

[in] QueryOrSubscription

EvtQuery 或 EvtSubscribe 函式傳回之查詢的句柄。

[in] PropertyId

要擷取之查詢資訊的標識碼。 如需標識符清單，請參閱 EVT_QUERY_PROPERTY_ID 列舉。

[in] PropertyValueBufferSize

PropertyValueBuffer 緩衝區的大小，以位元組為單位。

[in] PropertyValueBuffer

將接收查詢資訊的呼叫端配置緩衝區。 緩衝區包含 EVT_VARIANT 物件。 您可以將此參數設定為 NULL ，以判斷所需的緩衝區大小。

[out] PropertyValueBufferUsed

如果函式因ERROR_INSUFFICIENT_BUFFER而失敗，則函式所使用的呼叫端配置緩衝區大小，或所需的緩衝區大小大小，以位元組為單位。

傳回值

傳回碼/值 Description
TRUE
 此函數已成功。
FALSE
 函式失敗。 若要取得錯誤碼，請呼叫 GetLastError 函 式。

備註

如果您將 EvtQueryTolerateQueryErrors 旗標傳遞至 EvtQuery 或 EvtSubscribeTolerateQueryErrors 旗標至 EvtSubscribe，您只需要呼叫此函式。

範例

如需示範如何使用此函式的範例，請參閱 查詢事件。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winevt.h
程式庫 Wevtapi.lib
Dll Wevtapi.dll

另請參閱

EvtQuery

EvtSubscribe