Função StrChrW (shlwapi.h)

Artigo
11/20/2024

Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere que corresponde ao caractere especificado. A comparação diferencia maiúsculas de minúsculas.

Sintaxe

PCWSTR StrChrW(
  [in] PCWSTR pszStart,
       WCHAR  wMatch
);

Parâmetros

[in] pszStart

Tipo: PTSTR

O endereço da cadeia de caracteres a ser pesquisada.

wMatch

Tipo: TCHAR

O caractere a ser usado para comparação.

Valor de retorno

Tipo: PTSTR

Retorna o endereço da primeira ocorrência do caractere na cadeia de caracteres se tiver êxito ou NULL caso contrário.

Observações

A comparação pressupõe pszStart aponta para o início de uma cadeia de caracteres terminada em nulo.

Nota

O cabeçalho shlwapi.h define StrChr 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 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 4.71 ou posterior)

Compartilhar via