다음을 통해 공유

HStringReference 클래스

  • 아티클

기존 문자열에서 만든 HSTRING을 나타냅니다.

구문

class HStringReference;

설명

새 HSTRING에서 백업 버퍼의 수명은 Windows 런타임 의해 관리되지 않습니다. 호출자는 힙 할당을 방지하고 메모리 누수 위험을 제거하기 위해 스택 프레임에 원본 문자열을 할당합니다. 또한 호출자는 연결된 HSTRING의 수명 동안 원본 문자열이 변경되지 기본 확인해야 합니다. 자세한 내용은 WindowsCreateStringReference 함수를 참조하세요.

멤버

공용 생성자

속성 설명
HStringReference::HStringReference HStringReference 클래스의 새 인스턴스를 초기화합니다.

공용 메서드

멤버 설명
HStringReference::CopyTo 현재 HStringReference 개체를 HSTRING 개체에 복사합니다.
HStringReference::Get 기본 HSTRING 핸들의 값을 검색합니다.
HStringReference::GetRawBuffer 기본 문자열 데이터에 대한 포인터를 검색합니다.

Public 연산자

이름 설명
HStringReference::operator= 다른 HStringReference 개체의 값을 현재 HStringReference 개체로 이동합니다.
HStringReference::operator== 두 매개 변수가 같은지 여부를 나타냅니다.
HStringReference::operator!= 두 매개 변수가 같지 않은지 여부를 나타냅니다.
HStringReference::operator< 첫 번째 매개 변수가 두 번째 매개 변수보다 작은지 여부를 나타냅니다.

상속 계층 구조

HStringReference

요구 사항

헤더: corewrappers.h

네임스페이스: Microsoft::WRL::Wrappers

HStringReference::CopyTo

현재 HStringReference 개체를 HSTRING 개체에 복사합니다.

HRESULT CopyTo(
   _Out_ HSTRING *str
   ) const throw();

매개 변수

str
복사본을 받는 HSTRING입니다.

설명

이 메서드는 WindowsDuplicateString 함수를 호출합니다 .

HStringReference::Get

기본 HSTRING 핸들의 값을 검색합니다.

HSTRING Get() const throw()

Return Value

기본 HSTRING 핸들의 값입니다.

HStringReference::GetRawBuffer

기본 문자열 데이터에 대한 포인터를 검색합니다.

const wchar_t* GetRawBuffer(unsigned int* length) const;

매개 변수

길이 데이터 길이를 int 받는 변수에 대한 포인터입니다.

Return Value

const 기본 문자열 데이터에 대한 포인터입니다.

HStringReference::HStringReference

HStringReference 클래스의 새 인스턴스를 초기화합니다.

template<unsigned int sizeDest>
HStringReference(wchar_t const (&str)[ sizeDest]) throw();

template<unsigned int sizeDest>
HStringReference(wchar_t const (&str)[ sizeDest],
                 unsigned int len) throw();

HStringReference(HStringReference&& other) throw();

매개 변수

sizeDest
대상 HStringReference 버퍼의 크기를 지정하는 템플릿 매개 변수입니다.

str
와이드 문자 문자열에 대한 참조입니다.

렌
이 작업에 사용할 str 매개 변수 버퍼의 최대 길이입니다. len 매개 변수를 지정하지 않으면 전체 str 매개 변수가 사용됩니다. len이 sizeDest보다 크면 len은 sizeDest-1로 설정됩니다.

기타
다른 HStringReference 개체입니다.

설명

첫 번째 생성자는 매개 변수 str와 크기가 같은 새 HStringReference 개체를 초기화합니다.

두 번째 생성자는 매개 변수 len에 의해 크기가 지정되는 새 HStringReference 개체를 초기화합니다.

세 번째 생성자는 새 HStringReference 개체를 다른 매개 변수의 값으로 초기화한 다음 다른 매개 변수를 삭제합니다.

HStringReference::operator=

다른 HStringReference 개체의 값을 현재 HStringReference 개체로 이동합니다.

HStringReference& operator=(HStringReference&& other) throw()

매개 변수

기타
기존 HStringReference 개체입니다.

설명

기존 다른 개체의 값이 현재 HStringReference 개체에 복사된 다음 다른 개체가 제거됩니다.

HStringReference::operator==

두 매개 변수가 같은지 여부를 나타냅니다.

inline bool operator==(
               const HStringReference& lhs,
               const HStringReference& rhs) throw()

inline bool operator==(
               const HSTRING& lhs,
               const HStringReference& rhs) throw()

inline bool operator==(
               const HStringReference& lhs,
               const HSTRING& rhs) throw()

매개 변수

Lhs
비교할 첫 번째 매개 변수입니다. lhs는HStringReference 개체 또는 HSTRING 핸들일 수 있습니다.

rhs
비교할 두 번째 매개 변수입니다. rhs는HStringReference 개체 또는 HSTRING 핸들일 수 있습니다.

Return Value

truelhs 및 rhs 매개 변수가 같으면 .이고, false그렇지 않으면 .

HStringReference::operator!=

두 매개 변수가 같지 않은지 여부를 나타냅니다.

inline bool operator!=(
               const HStringReference& lhs,
               const HStringReference& rhs) throw()

inline bool operator!=(
               const HSTRING& lhs,
               const HStringReference& rhs) throw()

inline bool operator!=(
               const HStringReference& lhs,
               const HSTRING& rhs) throw()

매개 변수

Lhs
비교할 첫 번째 매개 변수입니다. lhs는HStringReference 개체 또는 HSTRING 핸들일 수 있습니다.

rhs
비교할 두 번째 매개 변수입니다. rhs는HStringReference 개체 또는 HSTRING 핸들일 수 있습니다.

Return Value

truelhs 및 rhs 매개 변수가 같지 않으면 .이고, false그렇지 않으면 .

HStringReference::operator<

첫 번째 매개 변수가 두 번째 매개 변수보다 작은지 여부를 나타냅니다.

inline bool operator<(
    const HStringReference& lhs,
    const HStringReference& rhs) throw()

매개 변수

Lhs
비교할 첫 번째 매개 변수입니다. lhs는 .에 대한 참조 HStringReference일 수 있습니다.

rhs
비교할 두 번째 매개 변수입니다. rhs는 .에 대한 참조 HStringReference일 수 있습니다.

Return Value

truelhs 매개 변수가 rhs 매개 변수보다 작으면 .이고, false그렇지 않으면 .