Share via


Função WindowsCompareStringOrdinal (winstring.h)

Compara dois objetos HSTRING especificados e retorna um inteiro que indica sua posição relativa em uma ordem de classificação.

Sintaxe

HRESULT WindowsCompareStringOrdinal(
  HSTRING string1,
  HSTRING string2,
  INT32   *result
);

Parâmetros

string1

Tipo: [in] HSTRING

A primeira cadeia de caracteres a ser comparada.

string2

Tipo: [in] HSTRING

A segunda cadeia de caracteres a ser comparada.

result

Tipo: [out] INT32*

Um valor que indica a relação lexical entre string1 e string2.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
A comparação foi bem-sucedida.
E_INVALIDARG
result é NULL.

Comentários

Use a função WindowsCompareStringOrdinal para comparar dois objetos HSTRING . Após a conclusão da comparação, o parâmetro result out contém um dos três valores.

Valor Condição
-1 string1 é menor que string2.
0 string1 é igual a string2.
1 string1 é maior que string2.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winstring.h
Biblioteca WinRTType.lib