IDebugEngine3::SetSymbolPath

  • Article

Définit le chemin d’accès ou les chemins d’accès recherchés pour le débogage des symboles.

Syntaxe

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

Paramètres

szSymbolSearchPath
[in] Chaîne contenant le chemin de recherche de symboles ou les chemins d’accès. Pour plus d’informations, consultez « Remarques ». Ne peut pas avoir la valeur null.

szSymbolCachePath
[in] Chaîne contenant le chemin d’accès local où les symboles peuvent être mis en cache. Ne peut pas avoir la valeur null.

Flags
[in] Non utilisé ; toujours défini sur 0.

Valeur de retour

Si elle réussit, retourne S_OK ; sinon, retourne un code d’erreur.

Notes

La chaîne szSymbolSearchPath est une liste d’un ou plusieurs chemins, séparés par des points-virgules, pour rechercher des symboles. Ces chemins peuvent être un chemin local, un chemin de style UNC ou une URL. Ces chemins peuvent également être un mélange de différents types. Si le chemin d’accès est UNC (par exemple, \\Symserver\Symbols), le moteur de débogage doit déterminer si le chemin d’accès est vers un serveur de symboles et doit être en mesure de charger des symboles à partir de ce serveur, en les mettant en cache dans le chemin spécifié par szSymbolCachePath.

Le chemin d’accès aux symboles peut également contenir un ou plusieurs emplacements de cache. Les caches sont répertoriés dans l’ordre de priorité, avec le cache de priorité le plus élevé en premier et séparés par des symboles * . Par exemple :

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

La méthode LoadSymbols effectue la charge réelle des symboles.

Voir aussi