RemovePropA-Funktion (winuser.h)

Artikel
08/27/2023

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

Syntax

HANDLE RemovePropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Parameter

[in] hWnd

Typ: HWND

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

[in] lpString

Typ: LPCTSTR

Eine NULL-endende Zeichenfolge oder ein Atom, das eine Zeichenfolge identifiziert. Wenn es sich bei diesem Parameter um ein Atom handelt, muss er mit der GlobalAddAtom-Funktion erstellt worden sein. Das Atom, ein 16-Bit-Wert, muss in das Wort mit niedriger Ordnung von lpString platziert werden; Das Wort mit hoher Ordnung muss 0 (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.

Hinweise

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. Bei Bedarf muss die Anwendung die Datenhandles freigeben, die Einträgen zugeordnet sind, die aus einer Eigenschaftenliste entfernt wurden. Die Anwendung kann nur die eigenschaften entfernen, die sie hinzugefügt hat. Eigenschaften, die von anderen Anwendungen oder vom System selbst hinzugefügt wurden, dürfen nicht entfernt werden.

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

Ab Windows Vista unterliegt RemoveProp den Einschränkungen der 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 Eigenschaftenänderungen blockiert, gibt GetLastError5 zurück.

Beispiele

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

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)