estrutura PRINTER_INFO_7

  • Artigo

A estrutura PRINTER_INFO_7 especifica informações de impressora de serviços de diretório. Use essa estrutura com a função SetPrinter para publicar os dados de uma impressora no DS (serviço de diretório) ou para atualizar ou remover os dados publicados de uma impressora do DS. Use essa estrutura com a função GetPrinter para determinar se uma impressora é publicada no DS.

Sintaxe

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

Membros

pszObjectGUID

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o GUID do objeto de fila de impressão do serviço de diretório associado a uma impressora publicada. Use a função GetPrinter para recuperar esse GUID.

Antes de chamar SetPrinter, defina pszObjectGUID como NULL.

Dwaction

Indica a ação para a função SetPrinter a ser executada. Para a função GetPrinter , esse membro indica se a impressora especificada foi publicada. Esse membro pode ser uma combinação dos valores a seguir.

Valor Significado
DSPRINT_PENDING
0x80000000
 GetPrinter: indica que o sistema está tentando concluir uma operação de publicação ou publicação iniciada por uma chamada SetPrinter .
SetPrinter: esse valor não é válido.
DSPRINT_PUBLISH
0x00000001
 SetPrinter: publica os dados da impressora no DS.
GetPrinter: indica que a impressora foi publicada.
DSPRINT_REPUBLISH
0x00000008
 SetPrinter: os dados DS da impressora são não publicados e publicados novamente, atualizando todas as propriedades na impressora publicada. A nova publicação também altera o GUID da impressora publicada.
GetPrinter: nunca retorna esse valor.
DSPRINT_UNPUBLISH
0x00000004
 SetPrinter: remove os dados publicados da impressora do DS.
GetPrinter: indica que a impressora não foi publicada.
DSPRINT_UPDATE
0x00000002
 SetPrinter: Atualizações os dados publicados da impressora no DS.
GetPrinter: nunca retorna esse valor.

Comentários

A estrutura PRINTER_INFO_7 é usada em uma chamada SetPrinter para publicar informações de impressora no serviço de diretório. Os dados publicados incluem todos os valores e dados da impressora especificada encontrada nas chaves SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY ou SPLDS_USER_KEY criadas por SetPrinterDataEx.

Para SetPrinter, pszObjectGUID deve ser definido como NULL. Para GetPrinter, pszObjectGUID retorna o GUID do objeto de fila de impressão dos serviços de diretório associado a uma impressora publicada. Você pode usar esse GUID com métodos ADSI (Active Directory Services Interface) para recuperar dados publicados para a impressora. No entanto, o método recomendado para recuperar dados publicados é chamar a função GetPrinterDataEx .

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winspool.h (inclua Windows.h)
Nomes Unicode e ANSI
 _PRINTER_INFO_7W (Unicode) e _PRINTER_INFO_7A (ANSI)

Confira também

Impressão

Estruturas de API do Spooler de Impressão