SHInvokePrinterCommandA-Funktion (shellapi.h)
Führt einen Befehl für ein Druckerobjekt aus.
Syntax
BOOL SHInvokePrinterCommandA(
[in, optional] HWND hwnd,
UINT uAction,
[in] LPCSTR lpBuf1,
[in, optional] LPCSTR lpBuf2,
BOOL fModal
);
Parameter
[in, optional] hwnd
Typ: HWND
Das Handle des übergeordneten Fensters aller Fenster oder Dialogfelder, die während des Vorgangs erstellt werden.
uAction
Typ: UINT
Der Typ des auszuführenden Druckervorgangs. Einer der folgenden Werte:
PRINTACTION_OPEN (0)
0x0. Öffnen Sie den von lpBuf1 angegebenen Drucker. Der lpBuf2-Parameter wird ignoriert.
PRINTACTION_PROPERTIES (1)
0x1. Zeigen Sie die Eigenschaftenseiten für den von lpBuf1 angegebenen Drucker an. Der lpBuf2-Parameter kann NULL sein oder ein bestimmtes anzuzeigenes Eigenschaftenblatt benennen, entweder anhand des Namens oder der Nummer. Wenn der hohe WORD-Wert von lpBuf2 ungleich null ist, wird davon ausgegangen, dass dieser Parameter ein Zeiger auf einen Puffer ist, der den Namen des zu öffnenden Blatts enthält. Andernfalls wird lpBuf2 als nullbasierter Index des zu öffnenden Eigenschaftenblatts betrachtet.
PRINTACTION_NETINSTALL (2)
0x2. Installieren Sie den von lpBuf1 angegebenen Netzwerkdrucker. Der lpBuf2-Parameter wird ignoriert.
PRINTACTION_NETINSTALLLINK (3)
0x3. Erstellen Sie eine Verknüpfung mit dem von lpBuf1 angegebenen Netzwerkdrucker. Der parameter lpBuf2 gibt das Laufwerk und den Pfad des Ordners an, in dem die Verknüpfung erstellt werden soll. Der Netzwerkdrucker muss bereits auf dem lokalen Computer installiert sein.
PRINTACTION_TESTPAGE (4)
0x4. Drucken Sie eine Testseite auf dem von lpBuf1 angegebenen Drucker. Der lpBuf2-Parameter wird ignoriert.
PRINTACTION_OPENNETPRN (5)
0x5. Öffnen Sie den von lpBuf1 angegebenen Netzwerkdrucker. Der lpBuf2-Parameter wird ignoriert.
PRINTACTION_DOCUMENTDEFAULTS (6)
0x6. Zeigt die Standarddokumenteigenschaften für den von lpBuf1 angegebenen Drucker an. Der lpBuf2-Parameter wird ignoriert.
PRINTACTION_SERVERPROPERTIES (7)
0x7. Zeigt die Eigenschaften für den von lpBuf1 angegebenen Druckerserver an. Der lpBuf2-Parameter wird ignoriert.
[in] lpBuf1
Typ: LPCTSTR
Zeiger auf eine NULL-endende Zeichenfolge, die zusätzliche Informationen für den Druckerbefehl enthält. Die in diesem Parameter enthaltenen Informationen hängen vom Wert von uAction ab.
[in, optional] lpBuf2
Typ: LPCTSTR
Zeiger auf eine NULL-endende Zeichenfolge, die zusätzliche Informationen für den Druckerbefehl enthält. Die in diesem Parameter enthaltenen Informationen hängen vom Wert von uAction ab.
fModal
Typ: BOOL
TRUE , um anzugeben, dass SHInvokePrinterCommand erst zurückgegeben werden soll, wenn der Befehl abgeschlossen ist. FALSE , wenn die Funktion zurückgegeben werden soll, sobald der Befehl initialisiert wurde.
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn dies erfolgreich war. andernfalls FALSE.
Hinweise
Wenn ein Druckername von lpBuf1 angegeben wird, kann der Name entweder der Name eines lokalen Druckers oder des Servers sein und den Namen eines Netzwerkdruckers freigeben. Wenn Sie einen Netzwerkdruckernamen angeben, muss der Name in folgendem Format angegeben werden:
"\\<server><shared printer name>"
Diese Funktion ist in Shell-Versionen 4.71 und höher implementiert. Um die Abwärtskompatibilität mit früheren Shell-Versionen zu gewährleisten, sollte diese Funktion nicht explizit verwendet werden. Stattdessen sollten die Funktionen LoadLibrary und GetProcAddress verwendet werden, um die Funktionsadresse abzurufen.
Hinweis
Der Shellapi.h-Header definiert SHInvokePrinterCommand als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shellapi.h |
Bibliothek | Shell32.lib |
DLL | Shell32.dll (Version 4.71 oder höher) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für