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 |