Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Recupera una subcadena de la cadena especificada. La subcadena comienza en una posición de carácter especificada y tiene una longitud especificada.
Syntax
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 esta 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 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 de retorno | Description |
|---|---|
|
La subcadena se creó correctamente. |
|
newString es NULL o startIndex más longitud es mayor que MAXUINT32, que es 4.294.967.295; es decir, 0xFFFFFFFF hexadecimal. |
|
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. |
|
No se pudo asignar la nueva subcadena. |
Observaciones
Cada llamada a la función WindowsSubstringWithSpecifiedLength debe coincidir con una llamada correspondiente a WindowsDeleteString.
Requisitos
| Requirement | Importancia |
|---|---|
| Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo admitido | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de |
Windows |
| Header | winstring.h |
| Library | mincore.lib |