Función RemovePropW (winuser.h)

Artículo
03/04/2024

Quita una entrada de la lista de propiedades de la ventana especificada. La cadena de caracteres especificada identifica la entrada que se va a quitar.

Sintaxis

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

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana cuya lista de propiedades se va a cambiar.

[in] lpString

Tipo: LPCTSTR

Cadena de caracteres terminada en null o un átomo que identifica una cadena. Si este parámetro es un átomo, debe haberse creado con la función GlobalAddAtom . El átomo, un valor de 16 bits, debe colocarse en la palabra de orden bajo de lpString; la palabra de orden superior debe ser cero.

Valor devuelto

Tipo: HANDLE

El valor devuelto identifica los datos especificados. Si los datos no se encuentran en la lista de propiedades especificada, el valor devuelto es NULL.

Comentarios

El valor devuelto es el valor hData que se pasó a SetProp; es un valor definido por la aplicación. Tenga en cuenta que esta función solo destruye la asociación entre los datos y la ventana. Si procede, la aplicación debe liberar los identificadores de datos asociados a las entradas quitadas de una lista de propiedades. La aplicación solo puede quitar esas propiedades que ha agregado. No debe quitar las propiedades agregadas por otras aplicaciones ni por el propio sistema.

La función RemoveProp devuelve el identificador de datos asociado a la cadena para que la aplicación pueda liberar los datos asociados al identificador.

A partir de Windows Vista, RemoveProp está sujeto a las restricciones del aislamiento de privilegios de la interfaz de usuario (UIPI). Un proceso solo puede llamar a esta función en una ventana que pertenezca a un proceso de nivel de integridad menor o igual. Cuando UIPI bloquea los cambios de propiedad, GetLastError devolverá 5.

Ejemplos

Para obtener un ejemplo, vea Eliminar una propiedad window.

Nota

El encabezado winuser.h define RemoveProp como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)