Método IXpsOMObjectFactory::CreateImageResource (xpsobjectmodel.h)

Artículo
12/22/2023

Crea una interfaz IXpsOMImageResource , que se usa para acceder a una secuencia de recursos de imagen.

Sintaxis

HRESULT CreateImageResource(
  [in]          IStream             *acquiredStream,
  [in]          XPS_IMAGE_TYPE      contentType,
  [in]          IOpcPartUri         *partUri,
  [out, retval] IXpsOMImageResource **imageResource
);

Parámetros

[in] acquiredStream

Secuencia de solo lectura que se va a asociar a este recurso. Este parámetro no debe ser NULL.

Importante Trate esta secuencia como un objeto Single-Threaded Apartment (STA); no vuelva a escribirlo.

[in] contentType

Valor de XPS_IMAGE_TYPE que describe el tipo de imagen de la secuencia a la que hace referencia acquiredStream.

[in] partUri

Interfaz IOpcPartUri que contiene el nombre del elemento que se va a asignar a este recurso. Este parámetro no debe ser NULL.

[out, retval] imageResource

Puntero a la nueva interfaz IXpsOMImageResource .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	contentType no era un valor de XPS_IMAGE_TYPE válido.
E_POINTER	acquiredStream, partUri o imageResource es NULL.

Comentarios

En el ejemplo de código siguiente se muestra cómo se usa este método para crear una nueva interfaz.


IXpsOMImageResource    *newInterface;
// The following values are defined outside of 
// this example.
//  IStream            *acquiredStream;
//  XPS_IMAGE_TYPE     contentType;
//  IOpcPartUri        *partUri;
    
// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    // The partUriString and acquiredStream variables 
    //   are defined outside of this example.
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateImageResource (
            acquiredStream,
            contentType,
            partUri,
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // use newInterface

            newInterface->Release();
        }
        partUri->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h