GetSpoolFileHandle, fonction

La fonction GetSpoolFileHandle récupère un handle pour le fichier de pool associé au travail actuellement soumis par l’application.

Syntaxe

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

Paramètres

hPrinter [in]

Handle de l’imprimante à laquelle le travail a été envoyé. Il doit s’agir du même handle que celui utilisé pour envoyer le travail. (Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.)

Valeur retournée

Si la fonction réussit, elle retourne un handle au fichier spool.

Si la fonction échoue, elle retourne INVALID_HANDLE_VALUE.

Notes

Avec le handle du fichier spool, votre application peut écrire dans le fichier spool avec des appels à WriteFilesuivis de CommitSpoolData.

Votre application ne doit pas appeler ClosePrinter sur hPrinter tant qu’elle n’a pas accédé au fichier spool pour la dernière fois. Ensuite, il doit appeler CloseSpoolFileHandle suivi de ClosePrinter. Les tentatives d’accès au handle de fichier du pool après la fermeture du hPrinter d’origine échouent même si le handle de fichier lui-même n’a pas été fermé. CloseSpoolFileHandle échouera lui-même si ClosePrinter est appelé en premier.

Cette fonction échoue si elle est appelée avant que le travail d’impression ait terminé le spoulage.

Spécifications

Voir aussi

Impression

Fonctions API du spouleur d’impression

OpenPrinter

Addprinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData