WindowsCreateString-Funktion (winstring.h)

Artikel
10/20/2023

Erstellt einen neuen HSTRING basierend auf der angegebenen Quellzeichenfolge.

Syntax

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

Parameter

sourceString

Typ: [in, optional] LPCWSTR

Eine NULL-Zeichenfolge, die als Quelle für den neuen HSTRING verwendet werden soll. Um eine neue, leere oder NULL-Zeichenfolge zu erstellen, übergeben Sie NULL für sourceString und 0 für länge.

length

Typ: [in] UINT32

Die Länge von sourceString in Unicode-Zeichen. Muss 0 sein, wenn sourceStringNULL ist.

string

Typ: [out] HSTRING*

Ein Zeiger auf den neu erstellten HSTRING oder NULL , wenn ein Fehler auftritt. Alle vorhandenen Inhalte in der Zeichenfolge werden überschrieben. Der HSTRING ist ein Standardhandletyp.

Rückgabewert

Typ: HRESULT

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der HSTRING wurde erfolgreich erstellt.
E_INVALIDARG	string ist NULL.
E_OUTOFMEMORY	Fehler beim Zuweisen des neuen HSTRING.
E_POINTER	sourceString ist NULL und die Länge ungleich 0.

Hinweise

Verwenden Sie die WindowsCreateString-Funktion , um einen neuen HSTRING zuzuweisen. Die Windows-Runtime kopiert die Zeichenfolge in den Sicherungspuffer des neuen HSTRING und verwaltet die Pufferlebensdauer mithilfe einer Verweisanzahl. Rufen Sie die WindowsCreateStringReference-Funktion auf, um eine Schnellpasszeichenfolge zu erstellen, die eine vorhandene Zeichenfolge verwendet, ohne sie zu kopieren.

Rufen Sie die WindowsDeleteString-Funktion auf, um die Zuordnung von HSTRING zu aufheben. Jeder Aufruf der WindowsCreateString-Funktion muss durch einen Aufruf von WindowsDeleteString abgeglichen werden.

Um eine neue, leere oder NULL-Zeichenfolge zu erstellen, übergeben Sie NULL für sourceString und 0 für länge.

Wenn sourceString über eingebettete NULL-Zeichen verfügt, kopiert die WindowsCreateString-Funktion alle Zeichen in das beendende NULL-Zeichen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winstring.h

Weitere Informationen

WindowsCreateStringReference

WindowsDeleteString

Freigeben über