wingdi.h


StartDoc

La función StartDoc comienza un trabajo de impresión. Esta función reemplaza a la secuencia de escape de impresora STARTDOC.

Sintaxis

int StartDoc(
    HDC hdc,             // manipulador de contexto de dispositivo
    CONST DOCINFO *lpdi  // dirección de estructura con nombres de fichero
   );

Parámetros

hdc: Identifica el contexto de dispositivo del trabajo de impresión.

lpdi: Puntero a una estructura DOCINFO que contiene el nombre del fichero de documento y el nombre del fichero de salida.

Valor de retorno

Si la función tiene éxito, el valor de retorno es mayor de cero.

Si la función falla, el valor de retorno es menor o igual a cero. Para obtener información adicional sobre el error, usar la función GetLastError.

Observaciones

Las aplicaciones deben llamar a la función StartDoc inmediatamente antes de empezar un trabajo de impresión. Usando esta función se asegura que documentos multipágina no se intercalaránm con otros trabajos de impresión.

Las aplicaciones pueden usar el valor retornado por StartDoc para recuperar o asignar la prioridad de un trabajo de impresión. En las llamadas a las funciones GetJob y SetJob se debe suministrar ese valor como uno de los argumentos.