Función WindowsSubstringWithSpecifiedLength (winstring.h)

  • Artículo

Recupera una subcadena de la cadena especificada. La subcadena comienza en una posición de carácter especificada y tiene una longitud especificada.

Sintaxis

HRESULT WindowsSubstringWithSpecifiedLength(
  HSTRING string,
  UINT32  startIndex,
  UINT32  length,
  HSTRING *newString
);

Parámetros

string

Tipo: [in] HSTRING

Cadena original.

startIndex

Tipo: [in] UINT32

Posición de carácter inicial de base cero de una subcadena en la instancia.

length

Tipo: [in] UINT32

Número de caracteres de la subcadena.

newString

Tipo: [out] HSTRING*

Cadena equivalente a la subcadena que comienza en startIndex en la cadena, o NULL si startIndex es igual a la longitud de la cadena.

Valor devuelto

Tipo: HRESULT

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La subcadena se creó correctamente.
E_INVALIDARG
 newString es NULL o startIndex más longitud es mayor que MAXUINT32, que es 4.294.967.295; es decir, 0xFFFFFFFF hexadecimal.
E_BOUNDS
 startIndex es mayor que la longitud de la cadena, o startIndex más longitud indica una posición que no está dentro de la cadena.
E_OUTOFMEMORY
 No se pudo asignar la nueva subcadena.

Comentarios

Cada llamada a la función WindowsSubstringWithSpecifiedLength debe coincidir con una llamada correspondiente a WindowsDeleteString.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winstring.h

Consulte también

WindowsDeleteString