SHInvokePrinterCommandA-Funktion (shellapi.h)

  • Artikel

Führt einen Befehl für ein Druckerobjekt aus.

Hinweis Diese Funktion ist ab Windows Vista veraltet. Es wird empfohlen, verben auf Druckern über IContextMenu oder ShellExecute aufzurufen.
 

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.

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)