다음을 통해 공유

IDWriteLocalizedStrings::GetString 메서드(dwrite.h)

  • 아티클

지정된 인덱스가 있는 문자열을 지정된 배열에 복사합니다.

구문

HRESULT GetString(
        UINT32 index,
  [out] WCHAR  *stringBuffer,
        UINT32 size
);

매개 변수

index

형식: UINT32

검사할 언어/문자열 쌍의 인덱스(0부터 시작)입니다.

[out] stringBuffer

형식: WCHAR*

언어/문자열 쌍에서 문자열을 수신하는 문자의 null 종료 배열입니다. 이 배열에 할당된 버퍼는 적어도 크기여야 합니다. GetStringLength 를 사용하여 이 메서드를 사용하기 전에 배열의 크기를 가져올 수 있습니다.

size

형식: UINT32

배열의 크기(문자)입니다. 크기는 종료 null 문자에 대한 공간을 포함해야 합니다. GetStringLength 를 사용하여 이 메서드를 사용하기 전에 배열의 크기를 가져올 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

반환된 문자열은 호출자가 할당해야 합니다. 다음 예제와 같이 GetString을 호출하기 전에 GetStringLength 메서드 를 사용하여 문자열 크기를 가져올 수 있습니다.

UINT32 length = 0;

// Get the string length.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetStringLength(index, &length);
}

// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
    hr = E_OUTOFMEMORY;
}

// Get the family name.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetString(index, name, length+1);
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트가 포함된 Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 dwrite.h
라이브러리 Dwrite.lib
DLL Dwrite.dll

추가 정보

IDWriteLocalizedStrings