Share via

IDebugEngine3::SetSymbolPath

  • Статья

Задает путь или пути, которые ищут символы отладки.

Синтаксис

int SetSymbolPath(
   string                    szSymbolSearchPath,
   string                    szSymbolCachePath,
   enum_LOAD_SYMBOLS_FLAGS   Flags
);

Параметры

szSymbolSearchPath
[in] Строка, содержащая путь поиска символов или пути. Дополнительные сведения см. в разделе "Примечания". Не может иметь значение null.

szSymbolCachePath
[in] Строка, содержащая локальный путь, в котором можно кэшировать символы. Не может иметь значение null.

Flags
[in] Не используется; всегда задано значение 0.

Возвращаемое значение

В случае успешного выполнения возвращается S_OK; в противном случае возвращает код ошибки.

Замечания

Строка szSymbolSearchPath — это список одного или нескольких путей, разделенных точкой с запятой, для поиска символов. Эти пути могут быть локальным путем, UNC-стилем или URL-адресом. Эти пути также могут быть сочетанием различных типов. Если путь равен UNC (например, \\Symserver\Symbols), подсистема отладки должна определить, является ли путь к серверу символов и должен иметь возможность загружать символы с этого сервера, кэширование их в пути, указанному в szSymbolCachePathфайле.

Путь к символам также может содержать одно или несколько расположений кэша. Кэши перечислены в порядке приоритета, в первую очередь кэш с самым высоким приоритетом и разделены символами *. Например:

\\symbols\symbols;\\someotherserver\symbols;c:\symbols\httpsymbols*https://msdl.microsoft.com

Метод LoadSymbols выполняет фактическую нагрузку символов.

См. также