WindowsGetStringRawBuffer-Funktion (winstring.h)

Ruft den Sicherungspuffer für die angegebene Zeichenfolge ab.

Syntax

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Die Parameter

string

Typ: [in, optional] HSTRING

Eine optionale Zeichenfolge, für die der Sicherungspuffer abgerufen werden soll. Kann NULL sein.

length

Typ: [out, optional] UINT32 *

Ein optionaler Zeiger auf einen UINT32- Wenn NULL für länge übergeben wird, wird sie ignoriert. Wenn die Länge ein gültiger Zeiger auf ein UINT32 ist und eine Zeichenfolge ein gültiger HSTRING-Wert ist, legt die Funktion beim erfolgreichen Abschluss den Wert fest, der auf die Anzahl der Unicode-Zeichen im Hintergrundpuffer für Zeichenfolgen (einschließlich eingebetteter NULL-Zeichen, jedoch mit Ausnahme der endenden NULL) verweist. Wenn die Länge ein gültiger Zeiger auf ein UINT32-Element ist und die ZeichenfolgeNULL ist, wird der Wert, auf den die Länge verweist, auf 0 festgelegt.

Rückgabewert

Typ: PCWSTR-

Ein Zeiger auf den Puffer, der den Sicherungsspeicher für Zeichenfolgen bereitstellt, oder die leere Zeichenfolge, wenn die ZeichenfolgeNULL oder die leere Zeichenfolge ist.

Bemerkungen

Verwenden Sie die WindowsGetStringRawBuffer-Funktion , um einen Zeiger auf den Sicherungspuffer eines HSTRING abzurufen.

Ändern Sie den Inhalt des Puffers nicht– ein HSTRING muss unveränderlich sein.

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