Udostępnij za pośrednictwem

IDebugEngine3::SetSymbolPath

  • Artykuł

Ustawia ścieżkę lub ścieżki, które są wyszukiwane dla symboli debugowania.

Składnia

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

Parametry

szSymbolSearchPath
[in] Ciąg zawierający ścieżkę wyszukiwania symboli lub ścieżki. Aby uzyskać szczegółowe informacje, zobacz "Uwagi". Nie może mieć wartości null.

szSymbolCachePath
[in] Ciąg zawierający ścieżkę lokalną, w której można buforować symbole. Nie może mieć wartości null.

Flags
[in] Nieużywana; zawsze ustawiono wartość 0.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca S_OK; w przeciwnym razie zwraca kod błędu.

Uwagi

Ciąg szSymbolSearchPath jest listą co najmniej jednej ścieżki rozdzielonej średnikami, aby wyszukać symbole. Te ścieżki mogą być ścieżką lokalną, ścieżką w stylu UNC lub adresem URL. Te ścieżki mogą być również kombinacją różnych typów. Jeśli ścieżka to UNC (na przykład \\Symserver\Symbols), aparat debugowania powinien określić, czy ścieżka jest do serwera symboli i powinna być w stanie załadować symbole z tego serwera, buforując je w ścieżce określonej przez szSymbolCachePath.

Ścieżka symbolu może również zawierać co najmniej jedną lokalizację pamięci podręcznej. Pamięci podręczne są wyświetlane w kolejności priorytetu, z pierwszą pamięcią podręczną o najwyższym priorytcie i oddzielone symbolami *. Na przykład:

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

Metoda LoadSymbols wykonuje rzeczywiste obciążenie symboli.

Zobacz też