Função SymSrvIsStoreW (dbghelp.h)

Determina se o caminho especificado aponta para um repositório de símbolos.

Sintaxe

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

Parâmetros

[in, optional] hProcess

O identificador de um processo que você passou anteriormente para a função SymInitialize. Se esse parâmetro for definido como NULL, a função determinará apenas se o repositório existe; caso contrário, a função determina se o repositório existe e contém uma entrada de processo para o identificador de processo especificado.

[in] path

O caminho para um repositório de símbolos. O caminho pode especificar o repositório de símbolos padrão (por exemplo, SRV*), apontar para um servidor de símbolo HTTP ou HTTPS ou especificar um caminho UNC, absoluto ou relativo para o repositório.

Valor de retorno

Se o caminho especificar um repositório de símbolos, a função retornará VERDADEIRO. Caso contrário, ele retornará FALSE. Para obter informações de erro estendidas, chame a função GetLastError.

Observações

Se o caminho apontar para o repositório de símbolos padrão (por exemplo, SRV*) ou para um servidor de símbolo HTTP ou HTTPS, a função pressupõe que o repositório exista.

Se houver um computador proxy entre o computador cliente e o servidor, a versão do SymSrv.dll no proxy não poderá ser menor do que a versão que está no cliente.

Todas as funções DbgHelp, como esta, são threaded simples. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.

Nota

O cabeçalho dbghelp.h define SymSrvIsStore como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	dbghelp.h
biblioteca	Dbghelp.lib
de DLL	Dbghelp.dll
redistribuível	DbgHelp.dll 6.3 ou posterior

Consulte também

do DbgHelp Functions