Función RemovePropA (winuser.h)

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 RemovePropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Parámetros

[in] hWnd

Tipo: HWND

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

[in] lpString

Tipo: LPCTSTR de

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 de

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

Observaciones

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 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 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)

Consulte también

AddAtom

conceptual de

GetProp

de referencia de

SetProp

propiedades de ventana de