SymSrvIsStoreW-Funktion (dbghelp.h)
Bestimmt, ob der angegebene Pfad auf einen Symbolspeicher zeigt.
Syntax
BOOL IMAGEAPI SymSrvIsStoreW(
[in, optional] HANDLE hProcess,
[in] PCWSTR path
);
Parameter
[in, optional] hProcess
Der 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 einen Prozesseintrag für den angegebenen Prozesshandle enthält.
[in] path
Der Pfad zu einem Symbolspeicher. Der Pfad kann den Standardsymbolspeicher (z. B. SRV*) angeben, auf einen HTTP- oder HTTPS-Symbolserver zeigen oder einen UNC-, absoluten oder relativen Pfad zum Speicher angeben.
Rückgabewert
Wenn der Pfad einen Symbolspeicher angibt, gibt die Funktion TRUEzurück. Andernfalls wird FALSE-zurückgegeben. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.
Bemerkungen
Wenn der Pfad auf den Standardsymbolspeicher (z. B. SRV*) oder auf einen HTTP- oder HTTPS-Symbolserver zeigt, wird davon ausgegangen, dass der Speicher vorhanden ist.
Wenn ein Proxycomputer zwischen dem Clientcomputer und dem Server vorhanden ist, darf die Version der SymSrv.dll auf dem Proxy nicht kleiner sein als die Version, die sich auf dem Client befindet.
Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anmerkung
Der dbghelp.h-Header definiert SymSrvIsStore als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Fenster |
Header- | dbghelp.h |
Library | Dbghelp.lib |
DLL- | Dbghelp.dll |
redistributable | DbgHelp.dll 6.3 oder höher |