RemovePropW-Funktion (winuser.h)

Artikel
11/20/2024

Entfernt einen Eintrag aus der Eigenschaftenliste des angegebenen Fensters. Die angegebene Zeichenfolge identifiziert den zu entfernenden Eintrag.

Syntax

HANDLE RemovePropW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpString
);

Parameter

[in] hWnd

Typ: HWND-

Ein Handle für das Fenster, dessen Eigenschaftsliste geändert werden soll.

[in] lpString

Typ: LPCTSTR-

Eine mit Null beendete Zeichenfolge oder ein Atom, das eine Zeichenfolge identifiziert. Wenn dieser Parameter ein Atom ist, muss er mithilfe der funktion GlobalAddAtom erstellt worden sein. Das Atom, ein 16-Bit-Wert, muss im Wort mit niedriger Reihenfolge von lpStringplatziert werden; Das Wort "Hochreihenfolge" muss null sein.

Rückgabewert

Typ: HANDLE

Der Rückgabewert identifiziert die angegebenen Daten. Wenn die Daten in der angegebenen Eigenschaftenliste nicht gefunden werden können, ist der Rückgabewert NULL-.

Bemerkungen

Der Rückgabewert ist der hData- Wert, der an SetProp-übergeben wurde; es ist ein anwendungsdefinierter Wert. Beachten Sie, dass diese Funktion nur die Zuordnung zwischen den Daten und dem Fenster zerstört. Falls zutreffend, muss die Anwendung die Datenhandles freigeben, die mit Einträgen verknüpft sind, die aus einer Eigenschaftsliste entfernt wurden. Die Anwendung kann nur die hinzugefügten Eigenschaften entfernen. Es darf keine Eigenschaften entfernen, die von anderen Anwendungen oder vom System selbst hinzugefügt werden.

Die RemoveProp--Funktion gibt das der Zeichenfolge zugeordnete Datenhandle zurück, sodass die Anwendung die dem Handle zugeordneten Daten freigeben kann.

Ab Windows Vista unterliegt RemoveProp- den Einschränkungen der Benutzeroberflächenberechtigungsisolation (User Interface Privilege Isolation, UIPI). Ein Prozess kann diese Funktion nur in einem Fenster aufrufen, das zu einem Prozess mit geringerer oder gleicher Integritätsebene gehört. Wenn UIPI Eigenschaftsänderungen blockiert, gibt GetLastError-5zurück.

Beispiele

Ein Beispiel finden Sie unter Löschen einer Window-Eigenschaft.

Anmerkung

Der winuser.h-Header definiert RemoveProp als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)