Delen via


De functie AddPrintProvidor

Belangrijk

Op 6 juli 2021 heeft KB5005010 een optionele configuratieoptie op basis van een register geïntroduceerd om de toegang tot deze API alleen te beperken tot beheerdersgebruikers. Deze optie is standaard uitgeschakeld.

Op 10 augustus 2021 wijzigt KB5005652 de standaardwaarde van deze configuratie om beheerdersrechten te vereisen voor het installeren van nieuwe printerstuurprogramma's.

Met de functie AddPrintProvidor wordt een lokale afdrukprovider geïnstalleerd en worden de configuratie-, gegevens- en providerbestanden gekoppeld.

Syntaxis

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

Parameterwaarden

pName [in]

Een aanwijzer naar een door null beëindigde tekenreeks die de naam aangeeft van de server waarop de provider moet worden geïnstalleerd. Voor systemen die alleen lokale installatie van providers ondersteunen, moet deze parameter NULL zijn.

niveau [in]

Het niveau van de structuur waarnaar pProviderInfo verwijst. Dit kan een van de volgende zijn.

Waarde Betekenis
1
Functie maakt gebruik van een PROVIDOR_INFO_1 structuur.
2
Functie maakt gebruik van een PROVIDOR_INFO_2 structuur.

pProviderInfo [in]

Een aanwijzer naar een afdrukproviderstructuur, zoals aangegeven door Niveau.

Retourwaarde

Als de functie slaagt, is de retourwaarde een niet-nulwaarde.

Als de functie mislukt, is de retourwaarde nul.

Opmerkingen

Opmerking

Dit is een blokkerende of synchrone functie en retourneert mogelijk niet onmiddellijk. Hoe snel deze functie retourneert, is afhankelijk van runtimefactoren zoals netwerkstatus, configuratie van afdrukserver en implementatiefactoren van printerstuurprogramma's die moeilijk te voorspellen zijn bij het schrijven van een toepassing. Als u deze functie aanroept vanuit een thread die interactie met de gebruikersinterface beheert, kan de toepassing niet reageren.

Voordat een toepassing de functie AddPrintProvidor aanroept, moeten alle bestanden die door de provider zijn vereist, worden gekopieerd naar de SYSTEM32 map.

Een provider die is toegevoegd door AddPrintProvidor , kan worden verwijderd door DeletePrintProvidor aan te roepen.

Vereisten

Voorwaarde Waarde
Minimaal ondersteunde client
Windows 2000 Professional [alleen desktop-apps]
Minimaal ondersteunde server
Windows 2000 Server [alleen desktop-apps]
Koptekst
Winspool.h (inclusief Windows.h)
Bibliotheek
Winspool.lib
DLL
Winspool.drv
Unicode- en ANSI-namen
AddPrintProvidorW (Unicode) en AddPrintProvidorA (ANSI)

Zie ook

Afdrukken

Spooler-API-functies afdrukken

DeletePrintProvidor-

PROVIDOR_INFO_1

PROVIDOR_INFO_2