Compartilhar via

Função PathMatchSpecExW (shlwapi.h)

  • Artigo

Corresponde a um nome de arquivo de um caminho em relação a um ou mais padrões de nome de arquivo.

Sintaxe

LWSTDAPI PathMatchSpecExW(
  [in] LPCWSTR pszFile,
  [in] LPCWSTR pszSpec,
  [in] DWORD   dwFlags
);

Parâmetros

[in] pszFile

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o caminho do qual o nome do arquivo a ser correspondido é obtido.

[in] pszSpec

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o padrão de nome de arquivo para o qual pesquisar. Esse pode ser o nome exato ou pode conter caracteres curinga. Se exatamente um padrão for especificado, defina o sinalizador PMSF_NORMAL em dwFlags. Se mais de um padrão for especificado, separe-os com ponto e vírgula e defina o sinalizador PMSF_MULTIPLE .

[in] dwFlags

Tipo: DWORD

Modifica a condição de pesquisa. Veja a seguir sinalizadores válidos.

PMSF_NORMAL (0x00000000)

O parâmetro pszSpec aponta para um único padrão de nome de arquivo a ser correspondido.

PMSF_MULTIPLE (0x00000001)

O parâmetro pszSpec aponta para uma lista delimitada por ponto e vírgula de padrões de nome de arquivo a serem correspondidos.

PMSF_DONT_STRIP_SPACES (0x00010000)

Se PMSF_NORMAL for usado, não ignore os espaços à esquerda na cadeia de caracteres apontada pelo pszSpec. Se PMSF_MULTIPLE for usado, não ignore os espaços à esquerda em cada tipo de arquivo contido na cadeia de caracteres apontada por pszSpec. Esse sinalizador pode ser combinado com PMSF_NORMAL e PMSF_MULTIPLE.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 Um padrão de nome de arquivo especificado no pszSpec correspondeu ao nome do arquivo encontrado na cadeia de caracteres apontada por pszFile.
S_FALSE
 Nenhum padrão de nome de arquivo especificado no pszSpec correspondeu ao nome do arquivo encontrado na cadeia de caracteres apontada por pszFile.

Comentários

Observação

O cabeçalho shlwapi.h define PathMatchSpecEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 7.0 ou posterior)

Confira também

Pathmatchspec