Función RegisterClipboardFormatA (winuser.h)

Registra un nuevo formato del Portapapeles. A continuación, este formato se puede usar como un formato de Portapapeles válido.

Sintaxis

UINT RegisterClipboardFormatA(
  [in] LPCSTR lpszFormat
);

Parámetros

[in] lpszFormat

Tipo: LPCTSTR de

Nombre del nuevo formato.

Valor devuelto

Tipo: UINT

Si la función se ejecuta correctamente, el valor devuelto identifica el formato del Portapapeles registrado.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Si ya existe un formato registrado con el nombre especificado, no se registra un nuevo formato y el valor devuelto identifica el formato existente. Esto permite que más de una aplicación copie y pegue datos con el mismo formato del Portapapeles registrado. Tenga en cuenta que la comparación de nombres de formato no distingue mayúsculas de minúsculas.

Los formatos del Portapapeles registrados se identifican mediante valores del intervalo 0xC000 a través de 0xFFFF.

Cuando los formatos del Portapapeles registrados se colocan en el Portapapeles o se recuperan del Portapapeles, deben estar en forma de un valor de HGLOBAL.

Ejemplos

Para obtener un ejemplo, vea Registrar un formato de Portapapeles.

Requisitos

Consulte también

del Portapapeles

conceptual de

CountClipboardFormats

EnumClipboardFormats

GetClipboardFormatName

de referencia de