WindowsGetStringRawBuffer-Funktion (winstring.h)

Ruft den Sicherungspuffer für die angegebene Zeichenfolge ab.

Syntax

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

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 die Länge übergeben wird, wird es ignoriert. Wenn length ein gültiger Zeiger auf einen UINT32 ist und Zeichenfolge ein gültiger HSTRING ist, legt die Funktion bei erfolgreicher Ausführung den Wert, auf den als Länge verwiesen wird, auf die Anzahl der Unicode-Zeichen im Sicherungspuffer für Zeichenfolge (einschließlich eingebetteter NULL-Zeichen, aber mit Ausnahme des beendenden NULL) fest. Wenn length ein gültiger Zeiger auf einen UINT32 ist und die ZeichenfolgeNULL ist, wird der Wert, auf den durch Länge verwiesen wird, auf 0 festgelegt.

Rückgabewert

Typ: PCWSTR

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

Hinweise

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

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

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