Compartir a través de

estructura de PRINTER_INFO_7

  • Artículo

La estructura de PRINTER_INFO_7 especifica información de impresora de servicios de directorio. Utilice esta estructura con la función SetPrinter para publicar los datos de una impresora en el servicio de directorio (DS), o para actualizar o quitar los datos publicados de una impresora del DS. Utilice esta estructura con la función GetPrinter para determinar si una impresora se publica en el DS.

Sintaxis

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

Miembros

pszObjectGUID

Puntero a una cadena terminada en null que contiene el GUID del objeto de cola de impresión del servicio de directorio asociado a una impresora publicada. Use la función GetPrinter para recuperar este GUID.

Antes de llamar a SetPrinter, establezca pszObjectGUID en NULL.

dwAction

Indica la acción de la función SetPrinter que se va a realizar. Para la función GetPrinter , este miembro indica si se publica la impresora especificada. Este miembro puede ser una combinación de los valores siguientes.

Valor Significado
DSPRINT_PENDING
0x80000000
 GetPrinter: indica que el sistema está intentando completar una operación de publicación o despublicación iniciada por una llamada a SetPrinter .
SetPrinter: este valor no es válido.
DSPRINT_PUBLISH
0x00000001
 SetPrinter: publica los datos de la impresora en el DS.
GetPrinter: indica que la impresora está publicada.
DSPRINT_REPUBLISH
0x00000008
 SetPrinter: los datos DS de la impresora no se publican y, a continuación, se publican de nuevo, actualizando todas las propiedades de la impresora publicada. La nueva publicación también cambia el GUID de la impresora publicada.
GetPrinter: nunca devuelve este valor.
DSPRINT_UNPUBLISH
0x00000004
 SetPrinter: quita los datos publicados de la impresora del DS.
GetPrinter: indica que la impresora no está publicada.
DSPRINT_UPDATE
0x00000002
 SetPrinter: Novedades los datos publicados de la impresora en el DS.
GetPrinter: nunca devuelve este valor.

Comentarios

La estructura de PRINTER_INFO_7 se usa en una llamada a SetPrinter para publicar información de impresora en el servicio de directorio. Los datos publicados incluyen todos los valores y datos de la impresora especificada que se encuentra en la SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY o claves de SPLDS_USER_KEY creadas por SetPrinterDataEx.

En SetPrinter, pszObjectGUID debe establecerse en NULL. Para GetPrinter, pszObjectGUID devuelve el GUID del objeto de cola de impresión de servicios de directorio asociado a una impresora publicada. Puede usar este GUID con métodos de interfaz de servicios de Active Directory (ADSI) para recuperar datos publicados para la impresora. Sin embargo, el método recomendado para recuperar datos publicados es llamar a la función GetPrinterDataEx .

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]
Encabezado
Winspool.h (incluye Windows.h)
Nombres Unicode y ANSI
 _PRINTER_INFO_7W (Unicode) y _PRINTER_INFO_7A (ANSI)

Consulte también

Impresión

Imprimir estructuras de API de Spooler