AddPrintProvidor – funkce

Důležité

Dne 6. července 2021 KB5005010 zavedla volitelnou možnost konfigurace na základě registru, která omezí přístup k tomuto rozhraní API pouze pro uživatele s oprávněními správce. Tato možnost byla vypnutá jako výchozí.

10. srpna 2021 KB5005652 změní výchozí hodnotu této konfigurace tak, aby vyžadovala práva správce k instalaci nových ovladačů tiskárny.

Funkce AddPrintProvidor nainstaluje místního poskytovatele tisku a propojí konfiguraci, data a soubory zprostředkovatele.

Syntaxe

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

Parametry

pName [in]

Ukazatel na řetězec ukončený hodnotou null, který určuje název serveru, na kterém má být poskytovatel nainstalován. Pro systémy, které podporují pouze místní instalaci zprostředkovatelů, by tento parametr měl mít hodnotu NULL.

úrovně [in]

Úroveň struktury, na kterou pProviderInfo odkazuje. Může to být jedna z následujících možností.

Hodnota	Význam
1	Funkce používá PROVIDOR_INFO_1 strukturu.
2	Funkce používá PROVIDOR_INFO_2 strukturu.

pProviderInfo [in]

Ukazatel na strukturu zprostředkovatele tisku, jak je uvedeno na úrovni.

Návratová hodnota

Pokud je funkce úspěšná, návratová hodnota je nenulová hodnota.

Pokud funkce selže, návratová hodnota je nula.

Poznámky

Poznámka:

Jedná se o blokující nebo synchronní funkci a nemusí se vrátit okamžitě. Jak rychle tato funkce vrací, závisí na faktorech doby běhu, jako je stav sítě, konfigurace tiskového serveru a faktory implementace ovladače tiskárny, které se při psaní aplikace obtížně predikují. Volání této funkce z vlákna, které spravuje interakci s uživatelským rozhraním, může znamenat, že aplikace přestane reagovat.

Než aplikace zavolá funkci AddPrintProvidor , všechny soubory vyžadované poskytovatelem musí být zkopírovány do SYSTEM32 adresáře.

Zprostředkovatel přidaný addPrintProvidor může být odebrán voláním DeletePrintProvidor.

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows 2000 Professional [jenom desktopové aplikace]
Minimální podporovaný server	Windows 2000 Server [jenom desktopové aplikace]
Záhlaví	Winspool.h (včetně Windows.h)
Knihovna	Winspool.lib
DLL	Winspool.drv
Názvy Unicode a ANSI	AddPrintProvidorW (Unicode) a AddPrintProvidorA (ANSI)

Viz také

Tisk

funkcí rozhraní API zařazování tisku

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2