Função InitializePrintMonitor (winsplp.h)
A função InitializePrintMonitor é obsoleta e tem suporte apenas para fins de compatibilidade. Novos monitores de impressão devem implementar InitializePrintMonitor2 para que possam ser usados com clusters de servidor de impressão.
A função InitializePrintMonitor de um monitor de impressão inicializa um monitor de impressão.
Sintaxe
LPMONITOREX InitializePrintMonitor(
[in] LPWSTR pRegistryRoot
);
Parâmetros
[in] pRegistryRoot
Ponteiro fornecido pelo chamador para uma cadeia de caracteres que identifica um caminho do Registro que o monitor de impressão pode usar para armazenar valores específicos do monitor.
Retornar valor
Se a operação for bem-sucedida, a função deverá retornar um ponteiro para uma estrutura MONITOREX . Caso contrário, a função deve chamar SetLastError (descrito na documentação do SDK do Microsoft Windows) para definir um código de erro e retornar NULL.
Comentários
A função InitializePrintMonitor deve ser exportada por monitores de idioma e por DLLs do servidor de monitor de porta. A função é chamada imediatamente depois que a DLL do monitor é carregada e não é chamada novamente até que a DLL seja recarregada. Suas finalidades são permitir que o monitor se inicialize e fornecer ao spooler ponteiros para funções de monitor internas. Ponteiros de função estão contidos em uma estrutura MONITOR , que é referenciada por meio da função MONITOREX .
O parâmetro pRegistryRoot fornece um ponteiro a uma cadeia de caracteres que representa o caminho para uma chave do Registro MonitorName , em que MonitorName é o nome do monitor especificado quando a função AddMonitor do spooler foi chamada para adicionar o monitor. O monitor pode usar essa chave para armazenar valores e nomes de valor específicos do monitor. Quando a função DeleteMonitor do spooler é chamada, o spooler exclui a chave MonitorName e todos os valores armazenados abaixo dela. (As funções AddMonitor e DeleteMonitor são descritas na documentação do SDK do Windows.)
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winsplp.h (inclua Winsplp.h) |