Funzione GetPrintProcessorDirectory

Articolo
06/12/2023

La funzione GetPrintProcessorDirectory recupera il percorso della directory del processore di stampa nel server specificato.

Sintassi

BOOL GetPrintProcessorDirectory(
  _In_  LPTSTR  pName,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pPrintProcessorInfo,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parametri

pName [in]: Puntatore a una stringa con terminazione Null che specifica il nome del server. Se questo parametro è NULL, viene restituito un percorso locale.
pEnvironment [in]: Puntatore a una stringa con terminazione Null che specifica l'ambiente (ad esempio, Windows x86, Windows IA64 o Windows x64). Se questo parametro è NULL, viene usato l'ambiente corrente dell'applicazione chiamante e del computer client (non dell'applicazione di destinazione e del server di stampa).
Livello [in]: Livello della struttura. Questo valore deve essere 1.
pPrintProcessorInfo [out]: Puntatore a un buffer che riceve il percorso. Si noti che, per i sistemi operativi precedenti a Windows Server 2003 SP 1, il percorso è nel formato locale per il server, non il formato remoto true. Ad esempio, il percorso viene assegnato come "%Windir%\System32\Spool\Prtprocs\%Environment%" anziché "\\ServerName\Print$\Prtprocs\%Environment%", anche quando viene chiamato per un server remoto. Per i sistemi operativi Windows Server 2003 SP 1 e versioni successive, viene restituito il percorso remoto true.
cbBuf [in]: Dimensioni del buffer a cui punta pPrintProcessorInfo.
pcbNeeded [out]: Puntatore a un valore che specifica il numero di byte copiati se la funzione ha esito positivo o il numero di byte necessari se cbBuf è troppo piccolo.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	GetPrintProcessorDirectoryW (Unicode) e GetPrintProcessorDirectoryA (ANSI)

Vedi anche

Stampa
Funzioni dell'API spooler di stampa
AddPrintProcessor

Condividi tramite