SymGetSourceVarFromToken 函式 (dbghelp.h)

從 來源伺服器 權杖擷取與指定變數名稱相關聯的值。

語法

BOOL IMAGEAPI SymGetSourceVarFromToken(
  [in]           HANDLE hProcess,
  [in]           PVOID  Token,
  [in, optional] PCSTR  Params,
  [in]           PCSTR  VarName,
  [out]          PSTR   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。

需求

目標平台	Windows
標頭	dbghelp.h
程式庫	Dbghelp.lib
Dll	Dbghelp.dll
可轉散發套件	DbgHelp.dll 6.8 或更新版本