Compartilhar via

Função WindowsSubstringWithSpecifiedLength (winstring.h)

  • Artigo

Recupera uma subcadeia de caracteres da cadeia de caracteres especificada. A subcadeia de caracteres começa em uma posição de caractere especificado e tem um comprimento especificado.

Sintaxe

HRESULT WindowsSubstringWithSpecifiedLength(
  HSTRING string,
  UINT32  startIndex,
  UINT32  length,
  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.

length

Tipo: [in] UINT32

O número de caracteres na substring.

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 ou startIndex plus length é maior que MAXUINT32, que é 4.294.967.295; ou seja, 0xFFFFFFFF hexadecimais.
E_BOUNDS
 startIndex é maior que o comprimento da cadeia de caracteres ou startIndex plus length indica uma posição não dentro da cadeia de caracteres.
E_OUTOFMEMORY
 Falha ao alocar a nova subcadeia de caracteres.

Comentários

Cada chamada para a função WindowsSubstringWithSpecifiedLength deve ser correspondida com 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