SymGetSourceVarFromTokenW 函式 (dbghelp.h)
從 來源伺服器 權杖擷取與指定變數名稱相關聯的值。
語法
BOOL IMAGEAPI SymGetSourceVarFromTokenW(
[in] HANDLE hProcess,
[in] PVOID Token,
[in, optional] PCWSTR Params,
[in] PCWSTR VarName,
[out] PWSTR Value,
[in] DWORD Size
);
參數
[in] hProcess
進程的控制碼。 此控制碼之前必須傳遞至 SymInitialize 函式 。
[in] Token
標記的指標。
[in, optional] Params
不使用這個參數。
[in] VarName
要擷取其值之變數權杖的名稱。
[out] Value
緩衝區的指標,接收與 VarName 參數中指定的變數權杖相關聯的值。
[in] Size
Value緩衝區的大小,以字元為單位。
傳回值
如果函式成功,則傳回值為 TRUE。
如果函式失敗,傳回值為 FALSE。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
所有 DbgHelp 函式,例如此函式都是單一執行緒。 因此,從一個以上的執行緒呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將所有並行呼叫從一個以上的執行緒同步至此函式。
若要呼叫此函式的 Unicode 版本,請定義DBGHELP_TRANSLATE_TCHAR。
注意
dbghelp.h 標頭會根據 UNICODE 預處理器常數的定義,將 SymGetSourceVarFromToken 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
需求
目標平台 | Windows |
標頭 | dbghelp.h |
程式庫 | Dbghelp.lib |
Dll | Dbghelp.dll |
可轉散發套件 | DbgHelp.dll 6.8 或更新版本 |