WindowsSubstringWithSpecifiedLength 함수(winstring.h)

지정된 문자열에서 부분 문자열을 검색합니다. 부분 문자열은 지정된 문자 위치에서 시작하고 길이도 지정되어 있습니다.

구문

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

string

형식: [in] HSTRING

원래 문자열입니다.

startIndex

형식: [in] UINT32

이 인스턴스의 substring에 있는 0부터 시작하는 문자 위치입니다.

length

형식: [in] UINT32

substring에 있는 문자의 수입니다.

newString

형식: [out] HSTRING*

문자열의 startIndex에서 시작하는 부분 문자열과 동일한 문자열이거나 startIndex가 문자열 길이와 같으면 NULL입니다.

형식: HRESULT

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	부분 문자열이 성공적으로 만들어졌습니다.
E_INVALIDARG	newString 이 NULL이거나 startIndex 더 하기 길이 가 4,294,967,295인 MAXUINT32보다 큽니다. 즉, 16진수 0xFFFFFFFF.
E_BOUNDS	startIndex 가 문자열 길이보다 크거나 startIndex 더 하기 길이 가 문자열 내에 없는 위치를 나타냅니다.
E_OUTOFMEMORY	새 부분 문자열을 할당하지 못했습니다.

WindowsSubstringWithSpecifiedLength 함수에 대한 각 호출은 WindowsDeleteString에 대한 해당 호출과 일치해야 합니다.