HStringReference — Klasa

Reprezentuje HSTRING, który jest tworzony na podstawie istniejącego ciągu.

Składnia

class HStringReference;

Uwagi

Okres istnienia buforu zapasowego w nowym HSTRING nie jest zarządzany przez środowisko wykonawcze systemu Windows. Obiekt wywołujący przydziela ciąg źródłowy w ramce stosu, aby uniknąć alokacji sterty i wyeliminować ryzyko wycieku pamięci. Ponadto obiekt wywołujący musi upewnić się, że ciąg źródłowy pozostaje niezmieniony w okresie istnienia dołączonego HSTRING. Aby uzyskać więcej informacji, zobacz Funkcja WindowsCreateStringReference.

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
HStringReference::HStringReference	Inicjuje nowe wystąpienie klasy HStringReference.

Metody publiczne

Element członkowski	opis
HStringReference::CopyTo	Kopiuje bieżący HStringReference obiekt do obiektu HSTRING.
HStringReference::Get	Pobiera wartość bazowego dojścia HSTRING.
HStringReference::GetRawBuffer	Pobiera wskaźnik do danych ciągów bazowych.

Operatory publiczne

Nazwa/nazwisko	opis
HStringReference::operator=	Przenosi wartość innego HStringReference obiektu do bieżącego HStringReference obiektu.
HStringReference::operator==	Wskazuje, czy dwa parametry są równe.
HStringReference::operator!=	Wskazuje, czy dwa parametry nie są równe.
HStringReference::operator<	Wskazuje, czy pierwszy parametr jest mniejszy niż drugi parametr.

Hierarchia dziedziczenia

HStringReference

Wymagania

Nagłówek: corewrappers.h

Przestrzeń nazw: Microsoft::WRL::Wrappers

HStringReference::CopyTo

Kopiuje bieżący HStringReference obiekt do obiektu HSTRING.

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

Parametry

Str
HSTRING odbierający kopię.

Uwagi

Ta metoda wywołuje funkcję WindowsDuplicateString .

HStringReference::Get

Pobiera wartość bazowego dojścia HSTRING.

HSTRING Get() const throw()

Wartość zwracana

Wartość bazowego uchwytu HSTRING.

HStringReference::GetRawBuffer

Pobiera wskaźnik do danych ciągów bazowych.

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

Parametry

length Wskaźnik do zmiennej int , która odbiera długość danych.

Wartość zwracana

Wskaźnik const do danych ciągów bazowych.

HStringReference::HStringReference

Inicjuje nowe wystąpienie klasy 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();

Parametry

sizeDest
Parametr szablonu określający rozmiar buforu docelowego HStringReference .

Str
Odwołanie do ciągu o szerokim znaku.

len
Maksymalna długość buforu parametru str do użycia w tej operacji. Jeśli parametr len nie zostanie określony, zostanie użyty cały parametr str. Jeśli len jest większy niż rozmiarDest, len jest ustawiony na sizeDest-1.

Innych
Inny HStringReference obiekt.

Uwagi

Pierwszy konstruktor inicjuje nowy HStringReference obiekt o takim samym rozmiarze jak parametr str.

Drugi konstruktor inicjuje nowy HStringReference obiekt, który określa rozmiar według parametru len.

Trzeci konstruktor inicjuje nowy HStringReference obiekt do wartości innego parametru, a następnie niszczy drugi parametr.

HStringReference::operator=

Przenosi wartość innego HStringReference obiektu do bieżącego HStringReference obiektu.

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

Parametry

Innych
Istniejący HStringReference obiekt.

Uwagi

Wartość istniejącego innego obiektu jest kopiowana do bieżącego HStringReference obiektu, a następnie zostaje zniszczony inny obiekt.

HStringReference::operator==

Wskazuje, czy dwa parametry są równe.

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()

Parametry

Lhs
Pierwszy parametr do porównania. Lhs może być obiektem HStringReference lub uchwytem HSTRING.

Rhs
Drugi parametr do porównania. Rhs może być HStringReference obiektem lub uchwytem HSTRING.

Wartość zwracana

truejeśli parametry lhs i rhs są równe; w przeciwnym razie , false.

HStringReference::operator!=

Wskazuje, czy dwa parametry nie są równe.

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()

Parametry

Lhs
Pierwszy parametr do porównania. Lhs może być obiektem HStringReference lub uchwytem HSTRING.

Rhs
Drugi parametr do porównania. Rhs może być HStringReference obiektem lub uchwytem HSTRING.

Wartość zwracana

truejeśli parametry lhs i rhs nie są równe; w przeciwnym razie , false.

HStringReference::operator<

Wskazuje, czy pierwszy parametr jest mniejszy niż drugi parametr.

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

Parametry

Lhs
Pierwszy parametr do porównania. lhs może być odwołaniem do .HStringReference

Rhs
Drugi parametr do porównania. Rhs może być odwołaniem do HStringReference.

Wartość zwracana

truejeśli parametr lhs jest mniejszy niż parametr rhs; w przeciwnym razie , false.