Funzione WindowsSubstringWithSpecifiedLength (winstring.h)

Articolo
03/04/2024

Recupera una sottostringa dalla stringa specificata. La sottostringa inizia in corrispondenza della posizione del carattere specificata e ha la lunghezza specificata.

Sintassi

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

Parametri

string

Tipo: [in] HSTRING

Stringa originale.

startIndex

Tipo: [in] UINT32

Posizione iniziale in base zero del carattere di una sottostringa in questa istanza.

length

Tipo: [in] UINT32

Numero di caratteri nella sottostringa.

newString

Tipo: [out] HSTRING*

Stringa equivalente alla sottostringa che inizia da startIndex nella stringa oppure NULL se startIndex è uguale alla lunghezza della stringa.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	La sottostringa è stata creata correttamente.
E_INVALIDARG	newString è NULL o la lunghezza di startIndex è maggiore di MAXUINT32, ovvero 4.294.967.295; vale a dire, 0xFFFFFFFF esadecimali.
E_BOUNDS	startIndex è maggiore della lunghezza della stringa o la lunghezza di startIndex più indica una posizione non all'interno di una stringa.
E_OUTOFMEMORY	Impossibile allocare la nuova sottostringa.

Commenti

Ogni chiamata alla funzione WindowsSubstringWithSpecifiedLength deve essere associata a una chiamata corrispondente a WindowsDeleteString.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winstring.h

Vedi anche

WindowsDeleteString

Condividi tramite