Compartilhar via

Função WindowsSubstring (winstring.h)

  • Artigo

Recupera uma subcadeia de caracteres da cadeia de caracteres especificada. A subcadeia de caracteres começa na posição de caractere especificada.

Sintaxe

HRESULT WindowsSubstring(
  HSTRING string,
  UINT32  startIndex,
  HSTRING *newString
);

Parâmetros

string

Tipo: [in] HSTRING

A cadeia de caracteres original.

startIndex

Tipo: [in] UINT32

A posição do caractere inicial com base em zero de uma substring nessa instância.

newString

Tipo: [out] HSTRING*

Uma cadeia de caracteres equivalente à subcadeia de caracteres que começa em startIndex na cadeia de caracteres ou NULL se startIndex for igual ao comprimento da cadeia de caracteres.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A subcadeia de caracteres foi criada com êxito.
E_INVALIDARG
 newString é NULL.
E_BOUNDS
 startIndex é maior que o comprimento da cadeia de caracteres.
E_OUTOFMEMORY
 Falha ao alocar a nova subcadeia de caracteres.

Comentários

Cada chamada para a função WindowsSubstring deve ser correspondida a uma chamada correspondente para WindowsDeleteString.

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

Confira também

WindowsDeleteString