Metodo IXpsOMObjectFactory::CreateDocument (xpsobjectmodel.h)

Articolo
12/22/2023

Crea un'interfaccia IXpsOMDocument , che può contenere un set di interfacce IXpsOMPageReference in una sequenza ordinata.

Sintassi

HRESULT CreateDocument(
  [in]          IOpcPartUri    *partUri,
  [out, retval] IXpsOMDocument **document
);

Parametri

[in] partUri

Interfaccia IOpcPartUri contenente il nome della parte da assegnare a questa risorsa. Questo parametro non deve essere NULL.

[out, retval] document

Puntatore alla nuova interfaccia IXpsOMDocument .

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non solo, quelli nella tabella che segue. Per informazioni sui valori restituiti dell'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	partUri o document è NULL.

Commenti

Nell'esempio di codice seguente viene illustrato come viene usato questo metodo per creare una nuova interfaccia.


IXpsOMDocument    *newInterface;
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))
{
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateDocument (partUri, &newInterface);
        
        if (SUCCEEDED(hr))
        {
            // use newInterface

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

Requisiti


Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h