Fungsi WindowsSubstringWithSpecifiedLength (winstring.h)

Mengambil substring dari string yang ditentukan. Substring dimulai pada posisi karakter tertentu dan memiliki panjang yang ditentukan.

Syntax

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

Parameter-parameternya

string

Jenis: [in] HSTRING

String asli.

startIndex

Jenis: [in] UINT32

Posisi karakter awal berbasis nol dari substring dalam instans ini.

length

Jenis: [in] UINT32

Jumlah karakter dalam substring.

newString

Jenis: [out] HSTRING*

String yang setara dengan substring yang dimulai pada startIndex dalam string, atau NULL jika startIndex sama dengan panjang string.

Mengembalikan nilai

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode	Description
S_OK	Substring berhasil dibuat.
E_INVALIDARG	newStringadalah NULL, atau panjang startIndexplus lebih besar dari MAXUINT32, yaitu 4.294.967.295; yaitu, 0xFFFFFFFF heksadesimal.
E_BOUNDS	startIndex lebih besar dari panjang string, atau panjang startIndex plus menunjukkan posisi tidak dalam string.
E_OUTOFMEMORY	Gagal mengalokasikan substring baru.

Komentar

Setiap panggilan ke fungsi WindowsSubstringWithSpecifiedLength harus dicocokkan dengan panggilan yang sesuai ke WindowsDeleteString.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	winstring.h
Library	mincore.lib

Lihat juga

WindowsDeleteString