SymSrvIsStoreW function (dbghelp.h)
Determines whether the specified path points to a symbol store.
Syntax
BOOL IMAGEAPI SymSrvIsStoreW(
[in, optional] HANDLE hProcess,
[in] PCWSTR path
);
Parameters
[in, optional] hProcess
The handle of a process that you previously passed to the SymInitialize function. If this parameter is set to NULL, the function determines only whether the store exists; otherwise, the function determines whether the store exists and contains a process entry for the specified process handle.
[in] path
The path to a symbol store. The path can specify the default symbol store (for example, SRV*), point to an HTTP or HTTPS symbol server, or specify a UNC, absolute, or relative path to the store.
Return value
If the path specifies a symbol store, the function returns TRUE. Otherwise, it returns FALSE. To get extended error information, call the GetLastError function.
Remarks
If the path points to the default symbol store (for example, SRV*) or to an HTTP or HTTPS symbol server, the function assumes the store exists.
If there is a proxy computer between the client computer and the server, the version of the SymSrv.dll on the proxy cannot be less than the version that is on the client.
All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.
To call the Unicode version of this function, define DBGHELP_TRANSLATE_TCHAR.
Note
The dbghelp.h header defines SymSrvIsStore as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | dbghelp.h |
| Library | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistributable | DbgHelp.dll 6.3 or later |