Metodo IFaxServer::CreateDocument (faxcom.h)

Il metodo IFaxServer::CreateDocument crea un oggetto FaxDoc per un oggetto FaxServer specificato. L'oggetto FaxDoc consente a un utente di creare e trasmettere un documento a uno o più destinatari fax.

Sintassi

HRESULT CreateDocument(
  [in]  BSTR    FileName,
  [out] VARIANT *retval
);

Parametri

[in] FileName

Tipo: BSTR

Specifica una stringa con terminazione null contenente il percorso completo e il nome del file che contiene il documento fax da trasmettere. Il percorso può essere un percorso UNC o un percorso che inizia con una lettera di unità.

Questo parametro può contenere qualsiasi nome file locale o remoto valido. Il file deve essere un tipo di file registrato correttamente e il server fax deve essere in grado di accedere al file.

[out] retval

Tipo: VARIANT*

Puntatore a una struttura VARIANT che riceve un puntatore dell'interfaccia IDispatch a un oggetto FaxDoc . Il metodo restituisce un membro pdispVal con un tipo di dati VT_DISPATCH.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il metodo IFaxServer::CreateDocument recupera un puntatore dell'interfaccia IDispatch a un oggetto FaxDoc . Un'applicazione client fax può accedere direttamente all'interfaccia IFaxDoc chiamando il metodo IUnknown::QueryInterface per recuperare un puntatore dell'interfaccia. L'interfaccia IFaxDoc consente a un utente di impostare le proprietà per un documento fax e quindi trasmettere il documento.

Un'applicazione client fax non deve chiamare la funzione CoCreateInstance per recuperare un puntatore dell'interfaccia IFaxDoc perché non verrà creata un'istanza corretta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	faxcom.h
DLL	Faxcom.dll

Vedi anche

Interfacce API client del servizio fax

API client del servizio fax per Windows 2000

FaxDoc

FaxServer

IFaxServer

IUnknown::QueryInterface