다음을 통해 공유

WindowsCreateString 함수(winstring.h)

  • 아티클

지정된 원본 문자열을 기반으로 새 HSTRING 을 만듭니다.

구문

HRESULT WindowsCreateString(
  PCNZWCH sourceString,
  UINT32  length,
  HSTRING *string
);

매개 변수

sourceString

형식: [in, optional] LPCWSTR

새 HSTRING의 원본으로 사용할 null로 종료된 문자열입니다. 새, 빈 문자열 또는 NULL 문자열을 만들려면 sourceString의 경우 NULL을, 길이는 0을 전달합니다.

length

형식: [in] UINT32

sourceString의 길이(유니코드 문자)입니다. sourceString이 NULL인 경우 0이어야 합니다.

string

형식: [out] HSTRING*

새로 만든 HSTRING에 대한 포인터이거나 오류가 발생하는 경우 NULL 입니다. 문자열의 기존 콘텐츠를 덮어씁니다. HSTRING은 표준 핸들 형식입니다.

반환 값

형식: HRESULT

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

반환 코드 Description
S_OK
 HSTRING이 성공적으로 만들어졌습니다.
E_INVALIDARG
 string 은 NULL입니다.
E_OUTOFMEMORY
 새 HSTRING을 할당하지 못했습니다.
E_POINTER
 sourceString 은 NULL 이고 길이 는 0이 아닙니다.

설명

WindowsCreateString 함수를 사용하여 새 HSTRING을 할당합니다. Windows 런타임 새 HSTRING의 백업 버퍼에 문자열을 복사하고 참조 횟수를 사용하여 버퍼 수명을 관리합니다. WindowsCreateStringReference 함수를 호출하여 기존 문자열을 복사하지 않고 사용하는 빠른 전달 문자열을 만듭니다.

WindowsDeleteString 함수를 호출하여 HSTRING 할당을 취소합니다. WindowsCreateString 함수에 대한 각 호출은 WindowsDeleteString 호출과 일치해야 합니다.

새, 빈 문자열 또는 NULL 문자열을 만들려면 sourceString의 경우 NULL을, 길이는 0을 전달합니다.

sourceString에 null 문자가 포함된 경우 WindowsCreateString 함수는 모든 문자를 종료 null 문자에 복사합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 winstring.h

추가 정보

WindowsCreateStringReference

WindowsDeleteString