Compartilhar via

Função WindowsSubstringWithSpecifiedLength (winstring.h)

Recupera uma subcadeia de caracteres da cadeia de caracteres especificada. A subcadeia de caracteres começa em uma posição de caractere especificada 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 de caractere inicial baseada em zero de uma subcadeia de caracteres nesta instância.

length

Tipo: [in] UINT32

O número de carateres na subcadeia.

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.

Valor de retorno

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Description
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 hexadecimal.
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.

Observações

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

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header winstring.h
Library mincore.lib

Consulte também

WindowsDeleteString

  • Last updated on