Compartilhar via

IDebugEngine3::SetSymbolPath

  • Artigo

Define o caminho ou caminhos que são pesquisados para símbolos de depuração.

Sintaxe

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

Parâmetros

szSymbolSearchPath
[em] Cadeia de caracteres que contém o caminho ou caminhos de pesquisa de símbolos. Consulte "Observações" para obter detalhes. Não pode ser nulo.

szSymbolCachePath
[em] Cadeia de caracteres que contém o caminho local onde os símbolos podem ser armazenados em cache. Não pode ser nulo.

Flags
[em] Não utilizado; sempre definido como 0.

Valor de retorno

Se for bem-sucedido, retorna S_OK; caso contrário, retorna um código de erro.

Comentários

A cadeia de caracteres szSymbolSearchPath é uma lista de um ou mais caminhos, separados por ponto-e-vírgula, para procurar símbolos. Esses caminhos podem ser um caminho local, um caminho no estilo UNC ou uma URL. Esses caminhos também podem ser uma mistura de diferentes tipos. Se o caminho for UNC (por exemplo, \\Symserver\Symbols), o mecanismo de depuração deverá determinar se o caminho é para um servidor de símbolos e deverá ser capaz de carregar símbolos desse servidor, armazenando-os em cache no caminho especificado pelo szSymbolCachePath.

O caminho do símbolo também pode conter um ou mais locais de cache. Os caches são listados em ordem de prioridade, com o cache de prioridade mais alta primeiro e separados por símbolos *. Por exemplo:

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

O método LoadSymbols executa a carga real dos símbolos.

Confira também