WindowsDeleteString-Funktion (winstring.h)

Verringert die Verweisanzahl eines Zeichenfolgenpuffers.

Syntax

HRESULT WindowsDeleteString(
  HSTRING string
);

Parameter

string

Typ: [in] HSTRING

Die zu löschende Zeichenfolge. Wenn Zeichenfolge eine Schnellpasszeichenfolge ist, die von WindowsCreateStringReference erstellt wurde, oder wenn die ZeichenfolgeNULL oder leer ist, wird keine Aktion ausgeführt und S_OK zurückgegeben.

Rückgabewert

Typ: HRESULT

Diese Funktion gibt immer S_OK zurück.

Hinweise

Verwenden Sie die WindowsDeleteString-Funktion , um die Zuordnung eines HSTRING zu aufheben. Beim Aufrufen von WindowsDeleteString wird die Referenzanzahl des Sicherungspuffers verringert, und wenn die Verweisanzahl 0 erreicht, wird der Puffer vom Windows-Runtime aufgesetzt.

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

WindowsCreateString

WindowsCreateStringReference