Método IFaxServer::CreateDocument (faxcom.h)

El método IFaxServer::CreateDocument crea un objeto FaxDoc para un objeto FaxServer especificado. El objeto FaxDoc permite a un usuario crear y transmitir un documento a uno o varios destinatarios de fax.

Sintaxis

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

Parámetros

[in] FileName

Tipo: BSTR

Especifica una cadena terminada en NULL que contiene la ruta de acceso completa y el nombre del archivo que contiene el documento de fax que se va a transmitir. La ruta de acceso puede ser una ruta UNC o una ruta de acceso que comienza con una letra de unidad.

Este parámetro puede contener cualquier nombre de archivo local o remoto válido. El archivo debe ser un tipo de archivo registrado correctamente y el servidor de fax debe poder acceder al archivo.

[out] retval

Tipo: VARIANT*

Puntero a una estructura VARIANT que recibe un puntero de interfaz IDispatch a un objeto FaxDoc . El método devuelve un miembro pdispVal con un tipo de datos VT_DISPATCH.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El método IFaxServer::CreateDocument recupera un puntero de interfaz IDispatch a un objeto FaxDoc . Una aplicación cliente de fax también puede acceder directamente a la interfaz IFaxDoc llamando al método IUnknown::QueryInterface para recuperar un puntero de interfaz. La interfaz IFaxDoc permite al usuario establecer las propiedades de un documento de fax y, a continuación, transmitir el documento.

Una aplicación cliente de fax no debe llamar a la función CoCreateInstance para recuperar un puntero de interfaz IFaxDoc porque no se creará una instancia correcta.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	faxcom.h
Archivo DLL	Faxcom.dll

Consulte también

Interfaces de API de cliente de servicio de fax

API de cliente del servicio de fax para Windows 2000

FaxDoc

FaxServer

IFaxServer

IUnknown::QueryInterface