IDebugEngine3::SetSymbolPathIDebugEngine3::SetSymbolPath

Définit le chemin d’accès ou les chemins d’accès qui sont recherchée dans les symboles de débogage.Sets the path or paths that are searched for debugging symbols.

SyntaxeSyntax

HRESULT SetSymbolPath (  
   LPOLESTR            szSymbolSearchPath,  
   LPOLESTR            szSymbolCachePath,  
   LOAD_SYMBOLS_FLAGS  Flags  
);  
int SetSymbolPath(  
   string                    szSymbolSearchPath,   
   string                    szSymbolCachePath,   
   enum_LOAD_SYMBOLS_FLAGS   Flags  
);  

ParamètresParameters

ParamètreParameter DescriptionDescription
szSymbolSearchPath [in] Chaîne contenant le chemin d’accès de recherche de symboles ou les chemins d’accès.[in] String containing the symbol search path or paths. Pour plus d’informations, consultez la section « Notes ».See "Remarks" for details. Ne peut pas être null.Cannot be null.
szSymbolCachePath [in] Chaîne contenant le chemin d’accès local où les symboles peuvent être mis en cache.[in] String containing the local path where symbols can be cached. Ne peut pas être null.Cannot be null.
Flags [in] Pas utilisé ; toujours défini à 0.[in] Not used; always set to 0.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK ; Sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise returns an error code.

NotesRemarks

La chaîne szSymbolSearchPath est une liste d’un ou plusieurs chemins séparés par des points-virgules, rechercher des symboles.The string szSymbolSearchPath is a list of one or more paths, separated by semicolons, to search for symbols. Ces chemins d’accès peuvent être un chemin d’accès local, un chemin d’accès UNC-style ou une URL.These paths can be a local path, a UNC-style path, or a URL. Ces chemins d’accès peuvent également être un mélange de types différents.These paths can also be a mix of different types. Si le chemin d’accès est UNC (par exemple, \\Symserver\Symbols), puis le moteur de débogage doit déterminer si le chemin d’accès à un serveur de symboles et doit être en mesure de charger les symboles à partir de ce serveur, la mise en cache dans le chemin d’accès spécifié par szSymbolCachePath.If the path is UNC (for example, \\Symserver\Symbols), then the debug engine should determine if the path is to a symbol server and should be able to load symbols from that server, caching them in the path specified by szSymbolCachePath.

Le chemin d’accès des symboles peut également contenir un ou plusieurs emplacements du cache.The symbol path can also contain one or more cache locations. Les caches sont répertoriés par ordre de priorité, avec le cache de priorité le plus élevé en premier et séparés par des * symboles.Caches are listed in priority order, with the highest priority cache first, and separated by * symbols. Par exemple :For example:

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

Le LoadSymbols méthode exécute la charge réelle des symboles.The LoadSymbols method performs the actual load of the symbols.

Voir aussiSee Also

LoadSymbols LoadSymbols
IDebugEngine3IDebugEngine3