Función CoTaskMemAlloc (combaseapi.h)

Asigna un bloque de memoria de tareas de la misma manera que IMalloc::Alloc .

Sintaxis

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

Parámetros

[in] cb

Tamaño del bloque de memoria que se va a asignar, en bytes.

Valor devuelto

Si la función se ejecuta correctamente, devuelve el bloque de memoria asignado. De lo contrario, devuelve NULL.

Comentarios

CoTaskMemAlloc usa el asignador predeterminado para asignar un bloque de memoria de la misma manera que lo hace IMalloc::Alloc . No es necesario llamar a la función CoGetMalloc antes de llamar a CoTaskMemAlloc.

El contenido inicial del bloque de memoria devuelto no está definido; no hay ninguna garantía de que se haya inicializado el bloque. El bloque asignado puede ser mayor que cb bytes debido al espacio necesario para la alineación y para la información de mantenimiento.

Si cb es 0, CoTaskMemAlloc asigna un elemento de longitud cero y devuelve un puntero válido a ese elemento. Si no hay suficiente memoria disponible, CoTaskMemAlloc devuelve NULL. Las aplicaciones siempre deben comprobar el valor devuelto de esta función, incluso cuando se solicitan pequeñas cantidades de memoria, ya que no hay ninguna garantía de que se asigne la memoria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	combaseapi.h (incluya Objbase.h)
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

CoTaskMemFree

CoTaskMemRealloc

IMalloc::Alloc