Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
Erstellt einen neuen HSTRING basierend auf der angegebenen Quellzeichenfolge.
Syntax
HRESULT WindowsCreateString(
PCNZWCH sourceString,
UINT32 length,
HSTRING *string
);
Die Parameter
sourceString
Typ: [in, optional] LPCWSTR
Der UTF-16LE-codierte Textpuffer, der 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.
Dieser Puffer muss nicht null beendet werden. WindowsCreateString kopiert den Inhalt und fügt einen NULL-Terminator im neuen Puffer hinzu, der den zurückgegebenen HSTRING zurückgibt.
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 einer Zeichenfolge werden überschrieben. Der HSTRING ist ein Standardhandletyp.
Rückgabewert
Typ: HRESULT-
Diese Funktion kann einen dieser Werte zurückgeben.
| Rückgabecode | Description |
|---|---|
|
Die HSTRING wurde erfolgreich erstellt. |
|
Zeichenfolge ist NULL. |
|
Fehler beim Zuordnen des neuen HSTRING. |
|
sourceString ist NULL und die Länge ist ungleich Null. |
Bemerkungen
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 Schnelldurchlaufzeichenfolge zu erstellen, die eine vorhandene Zeichenfolge verwendet, ohne sie zu kopieren.
Rufen Sie die WindowsDeleteString-Funktion auf, um die Zuweisung von HSTRING aufzurufen. Jeder Aufruf der WindowsCreateString-Funktion muss mit einem 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 eingebettete NULL-Zeichen enthält, kopiert die WindowsCreateString-Funktion alle Zeichen in das endende Nullzeichen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows 8 [Desktop-Apps | UWP-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2012 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Fenster |
| Header | winstring.h |
| Library | mincore.lib |