Fonction SymSrvIsStore (dbghelp.h)

Détermine si le chemin d’accès spécifié pointe vers un magasin de symboles.

Syntaxe

BOOL IMAGEAPI SymSrvIsStore(
  [in, optional] HANDLE hProcess,
  [in]           PCSTR  path
);

Paramètres

[in, optional] hProcess

Handle d’un processus que vous avez précédemment passé à la fonction SymInitialize . Si ce paramètre a la valeur NULL, la fonction détermine uniquement si le magasin existe ; sinon, la fonction détermine si le magasin existe et contient une entrée de processus pour le handle de processus spécifié.

[in] path

Chemin d’accès à un magasin de symboles. Le chemin d’accès peut spécifier le magasin de symboles par défaut (par exemple, SRV*), pointer vers un serveur de symboles HTTP ou HTTPS, ou spécifier un chemin UNC, absolu ou relatif au magasin.

Valeur retournée

Si le chemin spécifie un magasin de symboles, la fonction retourne TRUE. Sinon, il retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

Remarques

Si le chemin pointe vers le magasin de symboles par défaut (par exemple, SRV*) ou vers un serveur de symboles HTTP ou HTTPS, la fonction suppose que le magasin existe.

S’il existe un ordinateur proxy entre l’ordinateur client et le serveur, la version du SymSrv.dll sur le proxy ne peut pas être inférieure à la version qui se trouve sur le client.

Toutes les fonctions DbgHelp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Pour appeler la version Unicode de cette fonction, définissez DBGHELP_TRANSLATE_TCHAR.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	dbghelp.h
Bibliothèque	Dbghelp.lib
DLL	Dbghelp.dll
Composant redistribuable	DbgHelp.dll 6.3 ou version ultérieure

Voir aussi

Fonctions DbgHelp