AddPrintProvidor, funkcja

Ważne

6 lipca 2021 r. KB5005010 wprowadzono opcjonalną opcję konfiguracji opartej na rejestrze, aby ograniczyć dostęp do tego interfejsu API tylko użytkownikom administracyjnym. Ta opcja była wyłączona jako domyślna.

10 sierpnia 2021 r. KB5005652 zmienia domyślną wartość tej konfiguracji, aby wymagać uprawnień administratora do instalowania nowych sterowników drukarek.

Funkcja AddPrintProvidor instaluje lokalnego dostawcę wydruku i łączy pliki konfiguracji, danych i dostawcy.

Składnia

BOOL AddPrintProvidor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pProviderInfo
);

Parametry

pName [in]

Wskaźnik do ciągu zakończonego wartością null, który określa nazwę serwera, na którym należy zainstalować dostawcę. W przypadku systemów obsługujących tylko lokalną instalację dostawców ten parametr powinien mieć wartość NULL.

Poziom [in]

Poziom struktury, do której wskazuje element pProviderInfo . Może to być jeden z następujących elementów.

Wartość	Znaczenie
1	Funkcja używa struktury PROVIDOR_INFO_1 .
2	Funkcja używa struktury PROVIDOR_INFO_2 .

pProviderInfo [in]

Wskaźnik do struktury dostawcy wydruku wskazywany przez poziom.

Wartość zwracana

Jeśli funkcja powiedzie się, zwracana wartość jest wartością niezerową.

Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość to zero.

Uwagi

Uwaga

Jest to funkcja blokująca lub synchroniczna i może nie zwracać natychmiast. Szybkość zwracania tej funkcji zależy od czynników czasu wykonywania, takich jak stan sieci, konfiguracja serwera wydruku i czynniki implementacji sterownika drukarki, które są trudne do przewidzenia podczas pisania aplikacji. Wywołanie tej funkcji z wątku, który zarządza interakcją z interfejsem użytkownika, może sprawić, że aplikacja będzie wydawała się nie odpowiadać.

Zanim aplikacja wywoła funkcję AddPrintProvidor , wszystkie pliki wymagane przez dostawcę muszą zostać skopiowane do katalogu SYSTEM32.

Dostawca dodany przez funkcję AddPrintProvidor może zostać usunięty przez wywołanie metody DeletePrintProvidor.

Wymagania

Wymaganie	Wartość
Minimalny obsługiwany klient	Windows 2000 Professional [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówek	Winspool.h (w tym Windows.h)
Biblioteka	Winspool.lib
DLL	Winspool.drv
Nazwy Unicode i ANSI	AddPrintProvidorW (Unicode) i AddPrintProvidorA (ANSI)

Zobacz też

drukowanie

funkcje interfejsu API buforu wydruku

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2