Функция SymSrvIsStoreW (dbghelp.h)

Статья
11/20/2024

Определяет, указывает ли указанный путь в хранилище символов.

Синтаксис

BOOL IMAGEAPI SymSrvIsStoreW(
  [in, optional] HANDLE hProcess,
  [in]           PCWSTR path
);

Параметры

[in, optional] hProcess

Дескриптор процесса, который вы ранее передали функции SymInitialize. Если для этого параметра задано значение NULL, функция определяет только наличие хранилища; в противном случае функция определяет, существует ли хранилище и содержит запись процесса для указанного дескриптора процесса.

[in] path

Путь к хранилищу символов. Путь может указать хранилище символов по умолчанию (например, SRV*), указать на сервер символов HTTP или HTTPS или указать UNC, абсолютный или относительный путь к хранилищу.

Возвращаемое значение

Если путь указывает хранилище символов, функция возвращает TRUE. В противном случае возвращается FALSE. Чтобы получить расширенные сведения об ошибке, вызовите функцию getLastError .

Замечания

Если путь указывает на хранилище символов по умолчанию (например, SRV*) или на сервер символов HTTP или HTTPS, функция предполагает, что хранилище существует.

Если между клиентским компьютером и сервером существует прокси-компьютер, версия SymSrv.dll на прокси-сервере не может быть меньше версии, которая находится на клиенте.

Все функции DbgHelp, такие как этот, являются одним потоком. Таким образом, вызовы из нескольких потоков в эту функцию, скорее всего, приведет к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все одновременные вызовы из нескольких потоков в эту функцию.

Чтобы вызвать версию этой функции Юникода, определите DBGHELP_TRANSLATE_TCHAR.

Заметка

Заголовок dbghelp.h определяет SymSrvIsStore как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.3 или более поздней версии

См. также

функций DbgHelp

Поделиться через