Função PathMatchSpecExA (shlwapi.h)

Artigo
11/20/2024

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

Sintaxe

LWSTDAPI PathMatchSpecExA(
  [in] LPCSTR pszFile,
  [in] LPCSTR 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 por 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.

Valor de retorno

Tipo: HRESULT

Retorna um dos seguintes valores.

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

Observações

Nota

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 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
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 7.0 ou posterior)

Consulte também

PathMatchSpec

Compartilhar via