SplPromptUIInUsersSession-Funktion (winsplp.h)

  • Artikel

Die SplPromptUIInUsersSession Funktion zeigt ein Standardmeldungsfeld in der Sitzung an, die durch den Druckerhandle und die Auftrags-ID angegeben ist.

Syntax

BOOL SplPromptUIInUsersSession(
  [in]  HANDLE        hPrinter,
  [in]  DWORD         JobId,
  [in]  PSHOWUIPARAMS pUIParams,
  [out] DWORD         *pResponse
);

Parameter

[in] hPrinter

Handle zum Drucker.

[in] JobId

Gibt den Druckauftrag an.

[in] pUIParams

Zeiger auf eine SHOWUIPARAMS-Struktur , die Werte enthält, die die Darstellung und das Verhalten des Meldungsfelds bestimmen.

[out] pResponse

Zeiger auf einen Speicherort, der entweder die Antwort des Benutzers oder die IDASYNC-Konstante enthält. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

Rückgabewert

Bei Erfolg gibt die SplPromptUIInUsersSession Funktion TRUE zurück, andernfalls WIRD FALSE zurückgegeben.

Hinweise

Wenn pUIParams ->bWaitauf FALSE festgelegt ist, wird diese Funktion sofort zurückgegeben, ohne auf die Antwort des Benutzers zu warten. In diesem Fall ist *pResponse auf IDASYNC festgelegt.

Wenn Sie diese Funktion in einem Treiber verwenden möchten, der unter Windows 2000 ausgeführt werden soll, müssen Sie spoolss.dll durch einen Aufruf der LoadLibrary-Funktion laden und dann die Adresse dieser Funktion in dieser DLL durch einen Aufruf der GetProcAddress-Funktion suchen. (LoadLibrary und GetProcAddress werden in der Microsoft Windows SDK-Dokumentation beschrieben.) Wenn der Aufruf von GetProcAddress fehlschlägt, müssen Sie einen alternativen Mechanismus zum Anzeigen von Benutzeroberflächenelementen verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Die SplPromptUIInUsersSession-Funktion ist in Windows XP und höher verfügbar.
Zielplattform Desktop
Kopfzeile winsplp.h (winsplp.h einschließen)
Bibliothek Spoolss.lib
DLL Spoolss.dll

Weitere Informationen

SHOWUIPARAMS

SplIsSessionZero