SymSrvIsStoreW 函式 (dbghelp.h)
判斷指定的路徑是否指向符號存放區。
語法
BOOL IMAGEAPI SymSrvIsStoreW(
[in, optional] HANDLE hProcess,
[in] PCWSTR path
);
參數
[in, optional] hProcess
您先前傳遞至 SymInitialize 函式的進程句柄。 如果此參數設定為 NULL,則函式只會判斷存放區是否存在;否則,函式會判斷存放區是否存在,並包含指定進程句柄的進程專案。
[in] path
符號存放區的路徑。 路徑可以指定預設符號存放區(例如 SRV*)、指向 HTTP 或 HTTPS 符號伺服器,或指定存放區的 UNC、絕對或相對路徑。
傳回值
如果路徑指定符號存放區,函式會傳回 true 。 否則,它會 FALSE傳回 。 若要取得擴充的錯誤資訊,請呼叫 getLastError 函式
言論
如果路徑指向預設符號存放區(例如 SRV*)或 HTTP 或 HTTPS 符號伺服器,則函式會假設存放區存在。
如果用戶端電腦與伺服器之間有 Proxy 計算機,Proxy 上的 SymSrv.dll 版本不能小於用戶端上的版本。
所有 DbgHelp 函式,例如此函式,都是單個線程。 因此,從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將多個線程的所有並行呼叫同步至此函式。
若要呼叫此函式的 Unicode 版本,請定義DBGHELP_TRANSLATE_TCHAR。
注意
dbghelp.h 標頭會將 SymSrvIsStore 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | dbghelp.h |
連結庫 | Dbghelp.lib |
DLL | Dbghelp.dll |
可轉散發 | DbgHelp.dll 6.3 或更新版本 |