Type et description du paramètre

char cShortSessionID
ID de session court de l’espace de présentation.
const PRINTINFO * const pPrintInfo
Pointeur vers la structure PRINTINFO, où les paramètres de l’imprimante sont mentionnés.
nFlags
Combinaison d'indicateurs binaires indiquant quels membres de la structure sont valides. Ces indicateurs peuvent être utilisés indépendamment ou en les associant ensemble pour restaurer la page de propriétés (définie dans PCSAPI32.H). Les indicateurs, ainsi que les membres valides correspondants dans la structure, sont les suivants :
Marquer
Membres valides dans la structure
PCS_PRINT_PDT
bPDTMode, lpPDTFile
PCS_PRINT_PRINTMODE
nPrtMode, lpPrtToDskAppFile, lpPrtToDskSepFile, lpPrinterName
PCS_PRINT_PROMPT_DIALOG
bPromptDialog
nBufSize
Doit être défini sur 0. Ceci est ignoré.
nSizeNeeded
Doit être défini sur 0. Ceci est ignoré.
bPromptDialog
Les valeurs possibles sont les suivantes :
  • Si TRUE, la boîte de dialogue Printer Setup s'affiche avant l'impression.
  • Si FALSE, la boîte de dialogue Printer Setup ne s'affiche pas avant l'impression.
bPDTMode
Les valeurs possibles sont les suivantes :
  • Si TRUE, la connexion est définie en mode PDT.
  • Si FALSE, la connexion est définie en mode non-PDT (mode GDI).
lpPDTFile
Utilisé uniquement si bPDTMode est défini sur TRUE. Ceci est ignoré si bPDTMode est défini sur FALSE.
Il s'agit d'une chaîne terminée par un caractère Null contenant le nom du fichier PDT et doit être l'un des éléments suivants :
  • NULL

    Le fichier PDT actuellement configuré dans la connexion est utilisé. Si aucun fichier PDT n'est déjà configuré dans la connexion, l'API échoue avec une exception.

  • Nom du fichier, sans le chemin

    lpPDTFile dans le sous-dossier PDFPDT du chemin d'installation de Z and I Emulator for Windows est utilisé.

  • Nom de chemin complet du fichier

    Si lpPDTFile n'existe pas, l'API échoue.

nPrtMode
Il s'agit d'une valeur énumérée qui indique le PrintMode de la connexion. Le type de données enum PRINTMODE est défini dans PCSAPI32.H. Le paramètre nPrtMode doit être l’un des suivants :
  • PrtToDskAppend (mode Print to Disk-Append)

    Cela équivaut à sélectionner l'option Append dans la boîte de dialogue Printer Setup → Printer → Print to Diskde la session hôte.

  • PrtToDskSeparate (mode Print to Disk-Separate)

    Cela équivaut à sélectionner l'option Separate dans la boîte de dialogue Printer Setup → Printer → Print to Disk de la session hôte.

  • WinDefaultPrinter (mode Windows Default Printer)

    Cela équivaut à sélectionner l'option Use Windows Default Printer dans la boîte de dialogue Printer Setup de la session hôte.

  • SpecificPrinter (mode Specific Printer)

    Cela équivaut à sélectionner une imprimante dans la boîte de dialogue Printer Setup de la session hôte, tout en laissant l'option Use Windows Default Printer décochée.

lpPrtToDskAppFile
Ceci est utilisé uniquement si nPrtMode est défini sur PrtToDskAppend.
Il s'agit d'une chaîne terminée par un caractère Null contenant le nom du fichier Print to Disk-Append et doit être l'un des éléments suivants :
  • NULL

    Le fichier actuellement configuré pour le mode PrtToDskAppend dans la connexion est utilisé. Si aucun fichier PDT n'est déjà configuré dans la connexion, l'API échouera.

  • Nom du fichier, sans le chemin

    Le chemin du répertoire des données d'application de classe utilisateur est utilisé pour localiser le fichier. Si le fichier existe, il est utilisé. Sinon, il sera créé une fois l’impression terminée.

  • Nom de chemin complet du fichier

    Le répertoire doit exister dans le chemin, sinon l'API échouera. Il n'est pas nécessaire que le fichier existe dans le chemin.

lpPrtToDskSepFile
Les valeurs possibles sont les suivantes :
  • Nom de chemin complet du fichier Print to Disk-Separate pour la session.
  • Une chaîne vide («  ») si aucun fichier Print to Disk-Separate n'est configuré pour la session.
  • Un nom de fichier tronqué si la taille du tampon n'est pas suffisante. Le membre nSizeNeeded contient la taille du tampon nécessaire.
lpPrinterName
Ceci est utilisé uniquement si nPrtMode est défini sur SpecificPrinter. Autrement, il est ignoré. Il s'agit d'une chaîne terminée par un caractère Null contenant le nom de l'imprimante. Si l’imprimante n’existe pas, ce membre échoue.
PrinterName doit avoir le format suivant : 
<Nom de l'imprimante> sur <Nom du port>
Par exemple :
  • IBM InfoPrint 40 PS sur port réseau
  • HP LaserJet série 4050 PCL 6 sur LPT1
ULONG * const pErrorInfo
Ceci est rempli avec les informations d'erreur étendues lorsque l'API échoue avec le code retour PCS_FAILURE. pErrorInfo doit être défini sur NULL par l'appelant, si les détails des erreurs ne sont pas nécessaires.

La section suivante décrit les indicateurs définis dans PCSAPI32.H.