SymSrvIsStore-Funktion (dbghelp.h)
Bestimmt, ob der angegebene Pfad auf einen Symbolspeicher verweist.
Syntax
BOOL IMAGEAPI SymSrvIsStore(
[in, optional] HANDLE hProcess,
[in] PCSTR path
);
Parameter
[in, optional] hProcess
Das Handle eines Prozesses, den Sie zuvor an die SymInitialize-Funktion übergeben haben. Wenn dieser Parameter auf NULL festgelegt ist, bestimmt die Funktion nur, ob der Speicher vorhanden ist. Andernfalls bestimmt die Funktion, ob der Speicher vorhanden ist, und enthält einen Prozesseintrag für das angegebene Prozesshandle.
[in] path
Der Pfad zu einem Symbolspeicher. Der Pfad kann den Standardsymbolspeicher (z. B. SRV*) angeben, auf einen HTTP- oder HTTPS-Symbolserver verweisen oder einen UNC-, absoluten oder relativen Pfad zum Speicher angeben.
Rückgabewert
Wenn der Pfad einen Symbolspeicher angibt, gibt die Funktion TRUE zurück. Andernfalls wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.
Hinweise
Wenn der Pfad auf den Standardsymbolspeicher (z. B. SRV*) oder auf einen HTTP- oder HTTPS-Symbolserver verweist, geht die Funktion davon aus, dass der Speicher vorhanden ist.
Wenn zwischen dem Clientcomputer und dem Server ein Proxycomputer vorhanden ist, kann die Version des SymSrv.dll auf dem Proxy nicht kleiner sein als die Version, die sich auf dem Client befindet.
Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll 6.3 oder höher |