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 |