Méthode IPrintDialogServices ::GetCurrentPortName (commdlg.h)
Récupère le nom du port actuel à utiliser avec PrintDlgEx.
Syntaxe
HRESULT GetCurrentPortName(
LPWSTR pPortName,
UINT *pcchSize
);
Paramètres
pPortName
Type : LPTSTR
Nom du port actuel.
pcchSize
Type : UINT*
Lors de l’entrée, la variable spécifie la taille, en caractères, de la mémoire tampon vers laquelle pointe le paramètre lpPortName . Lors de la sortie, la variable contient le nombre d’octets (ANSI) ou de caractères (Unicode), y compris le caractère null de fin, écrit dans la mémoire tampon.
Si la taille est égale à zéro à l’entrée, la fonction retourne la taille de mémoire tampon requise (en octets ou en caractères) dans pcchSize et n’utilise pas la mémoire tampon lpPortName .
Valeur retournée
Type : HRESULT
Si la méthode réussit, la valeur de retour est S_OK. S’il n’y a pas de port actuel, la valeur de retour est S_OK, la valeur retournée dans pcchSize est zéro et la mémoire tampon lpPortName est inchangée.
Si une erreur se produit, la valeur renvoyée est un code d’erreur COM. Pour plus d’informations, consultez Gestion des erreurs.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | commdlg.h (inclure Windows.h) |
| DLL | Comdlg32.dll |
Voir aussi
Bibliothèque de boîtes de dialogue commune
Conceptuel
Référence