共用方式為


IFaxServer::CreateDocument 方法 (faxcom.h)

IFaxServer::CreateDocument 方法會為指定的FaxServer物件建立FaxDoc物件。 FaxDoc 物件可讓使用者建立及傳輸檔給一或多個傳真收件者。

語法

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

參數

[in] FileName

類型: BSTR

指定以 Null 結尾的字串,其中包含要傳輸之傳真檔的完整路徑和檔名。 路徑可以是 UNC 路徑或開頭為驅動器號的路徑。

此參數可以包含任何有效的本機或遠端檔名。 檔案必須是正確註冊的檔類型,而且傳真伺服器必須能夠存取檔案。

[out] retval

類型: VARIANT*

VARIANT 結構的指標,該結構會接收FaxDoc物件的IDispatch介面指標。 方法會傳回具有VT_DISPATCH數據類型的 pdispVal 成員。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

IFaxServer::CreateDocument 方法會擷取 FaxDoc 物件的 IDispatch 介面指標。 傳真用戶端應用程式也可以呼叫 IUnknown::QueryInterface 方法來直接存取 IFaxDoc 介面,以擷取介面指標。 IFaxDoc 介面可讓使用者設定傳真文件的屬性,然後傳輸檔。

傳真用戶端應用程式不應該呼叫 CoCreateInstance 函式來擷取 IFaxDoc 介面指標,因為它不會正確具現化。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 faxcom.h
Dll Faxcom.dll

另請參閱

傳真服務用戶端 API 介面

適用於 Windows 2000 的傳真服務用戶端 API

FaxDoc

FaxServer

IFaxServer

IUnknown::QueryInterface