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

Weitere Informationen

DbgHelp-Funktionen