Freigeben über


CHString::LockBuffer-Methode (chstring.h)

[Die Klasse CHString ist Teil des WMI-Provider-Frameworks, das nun als endgültig betrachtet wird, und es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Die MI-APIs sollten für alle Neuentwicklungen verwendet werden.]

Die LockBuffer-Methode sperrt eine Zeichenfolge im Puffer.

Syntax

LPWSTR LockBuffer();

Rückgabewert

Gibt einen Zeiger auf ein CHString-Objekt oder eine NULL-beendete Zeichenfolge zurück.

Hinweise

Durch Aufrufen von LockBuffer erstellen Sie eine Kopie der Zeichenfolge und legen dann die Verweisanzahl auf -1 fest.

Wenn die Verweisanzahl auf -1 festgelegt ist, wird die Zeichenfolge im Puffer als gesperrt betrachtet, wodurch die Zeichenfolge auf zwei Arten geschützt wird:

  • Keine andere Zeichenfolge kann einen Verweis auf die Daten in der gesperrten Zeichenfolge abrufen, auch wenn diese Zeichenfolge der gesperrten Zeichenfolge zugewiesen ist.
  • Die gesperrte Zeichenfolge verweist nie auf eine andere Zeichenfolge, auch wenn diese andere Zeichenfolge in die gesperrte Zeichenfolge kopiert wird.
Indem Sie die Zeichenfolge im Puffer sperren, stellen Sie sicher, dass der exklusive Halteraum der Zeichenfolge für den Puffer intakt bleibt.

Nachdem Sie lockBuffer abgeschlossen haben, rufen Sie UnlockBuffer auf, um die Verweisanzahl auf 1 (1) zurückzusetzen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile chstring.h (include FwCommon.h)
Bibliothek FrameDyn.lib
DLL FrameDynOS.dll; FrameDyn.dll

Weitere Informationen

CHString

CHString::UnlockBuffer