MiniDumpWriteDump 函式 (minidumpapiset.h)

發行項
02/22/2024

將使用者模式迷你傾印資訊寫入指定的檔案。

語法

BOOL MiniDumpWriteDump(
  [in] HANDLE                            hProcess,
  [in] DWORD                             ProcessId,
  [in] HANDLE                            hFile,
  [in] MINIDUMP_TYPE                     DumpType,
  [in] PMINIDUMP_EXCEPTION_INFORMATION   ExceptionParam,
  [in] PMINIDUMP_USER_STREAM_INFORMATION UserStreamParam,
  [in] PMINIDUMP_CALLBACK_INFORMATION    CallbackParam
);

參數

[in] hProcess

要為其產生信息的處理程式句柄。

此句柄必須具有 PROCESS_QUERY_INFORMATION ，且 PROCESS_VM_READ 進程存取權。如果要收集句柄資訊，則也需要 PROCESS_DUP_HANDLE 存取權。如需詳細資訊，請參閱處理安全性和訪問許可權。呼叫端也必須 能夠THREAD_ALL_ACCESS存取 進程中的線程。如需詳細資訊，請參閱線程安全性和訪問許可權。

[in] ProcessId

要為其產生資訊之進程的標識碼。

[in] hFile

要寫入信息的檔案句柄。

[in] DumpType

要產生的信息類型。此參數可以是來自MINIDUMP_TYPE 列舉的一或多個值。

[in] ExceptionParam

MINIDUMP_EXCEPTION_INFORMATION 結構的指標，描述導致產生迷你傾印的用戶端例外狀況。如果此參數的值是 NULL，則迷你傾印檔案中不會包含例外狀況資訊。

[in] UserStreamParam

MINIDUMP_USER_STREAM_INFORMATION 結構的指標。如果此參數的值是 NULL，則迷你傾印檔案中不會包含任何使用者定義的資訊。

[in] CallbackParam

MINIDUMP_CALLBACK_INFORMATION 結構的指標，指定要接收擴充迷你傾印資訊的回呼例程。如果此參數的值是 NULL，則不會執行回呼。

傳回值

如果函式成功，則傳回值為 TRUE;否則，傳回值為 FALSE。若要擷取擴充的錯誤資訊，請呼叫 GetLastError。請注意，最後一個錯誤將是 HRESULT 值。

如果工作已取消，則最後一個錯誤碼為 HRESULT_FROM_WIN32(ERROR_CANCELLED)。

備註

MiniDumpCallback 函式會從 MiniDumpWriteDump 接收擴充的迷你傾印資訊。它也可讓呼叫端判斷寫入迷你傾印檔案的資訊粒度，因為回呼函式可以篩選默認資訊。

如果可能的話，應該從個別進程呼叫 MiniDumpWriteDump，而不是從傾印的目標進程呼叫。當目標進程尚未穩定時，這特別適用。例如，如果它剛當機。載入器死結是從目標進程中呼叫 MiniDumpWriteDump 的許多潛在副作用之一。如果無法從個別進程呼叫 MiniDumpWriteDump ，建議您擁有專用線程，其唯一用途是呼叫 MiniDumpWriteDump。這有助於確保堆疊在呼叫 MiniDumpWriteDump 之前尚未耗盡。

MiniDumpWriteDump 可能不會產生呼叫線程的有效堆疊追蹤。若要解決此問題，您必須先擷取呼叫線程的狀態，再呼叫 MiniDumpWriteDump ，並使用它做為 ExceptionParam 參數。其中一個做法是在__try/內強制例外狀況__except封鎖並使用 GetExceptionInformation 所提供的EXCEPTION_POINTERS資訊。或者，您可以從新的背景工作線程呼叫函式，並從傾印篩選此背景工作線程。

所有 DbgHelp 函式，例如此函式都是單個線程。因此，從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。若要避免這種情況，您必須將所有並行呼叫從多個線程同步處理到此函式。

規格需求

需求	值
目標平台	Windows
標頭	minidumpapiset.h (包含 Dbghelp.h)
程式庫	Dbghelp.lib
Dll	Dbghelp.dll;Dbgcore.dll
可轉散發套件	DbgHelp.dll 和 Dbgcore.dll