SymSrvIsStoreW, fonction (dbghelp.h)
Détermine si le chemin d’accès spécifié pointe vers un magasin de symboles.
Syntaxe
BOOL IMAGEAPI SymSrvIsStoreW(
[in, optional] HANDLE hProcess,
[in] PCWSTR path
);
Paramètres
[in, optional] hProcess
Handle d’un processus que vous avez passé précédemment à la fonction SymInitialize. Si ce paramètre est défini sur 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 de retour
Si le chemin d’accès spécifie un magasin de symboles, la fonction retourne TRUE. Sinon, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, 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, comme celle-ci, sont monothread. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement une altération inattendue du comportement ou 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.
Note
L’en-tête dbghelp.h définit SymSrvIsStore comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | dbghelp.h |
| bibliothèque | Dbghelp.lib |
| DLL | Dbghelp.dll |
| redistribuable | DbgHelp.dll 6.3 ou version ultérieure |