AddPrintProvidor işlevi

Önemli

6 Temmuz 2021'de , KB5005010 bu API'ye erişimi yalnızca yönetici kullanıcılarla kısıtlamak için isteğe bağlı bir kayıt defteri tabanlı yapılandırma seçeneği kullanıma sunulmuştur. Bu seçenek varsayılan olarak kapalıydı.

10 Ağustos 2021'de KB5005652 , yeni yazıcı sürücülerini yüklemek için yönetici hakları gerektirecek şekilde bu yapılandırmanın varsayılan değerini değiştirir.

AddPrintProvidor işlevi yerel bir yazdırma sağlayıcısı yükler ve yapılandırma, veri ve sağlayıcı dosyalarını bağlar.

Sözdizimi

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

Parametreler

pName [in]

Sağlayıcının yüklenmesi gereken sunucunun adını belirten null ile sonlandırılan bir dize işaretçisi. Yalnızca sağlayıcıların yerel yüklemesini destekleyen sistemler için bu parametre NULL olmalıdır.

Düzeyi [in]

pProviderInfo'nun işaret ettiği yapı düzeyi. Aşağıdakilerden biri olabilir.

Değer	Anlamı
1	İşlev PROVIDOR_INFO_1 bir yapı kullanır.
2	İşlev PROVIDOR_INFO_2 bir yapı kullanır.

pProviderInfo [in]

Düzey'de gösterildiği gibi, yazdırma sağlayıcısı yapısının işaretçisi.

Dönüş değeri

İşlev başarılı olursa, dönüş değeri sıfır olmayan bir değerdir.

İşlev başarısız olursa, dönüş değeri sıfır olur.

Açıklamalar

Uyarı

Bu, engelleyici veya zaman uyumlu bir işlevdir ve hemen döndürülmeyebilir. Bu işlevin ne kadar hızlı döndürüleceği ağ durumu, yazdırma sunucusu yapılandırması ve uygulama yazarken tahmin edilmesi zor olan yazıcı sürücüsü uygulama faktörleri gibi çalışma zamanı faktörlerine bağlıdır. Bu işlevin kullanıcı arabirimiyle etkileşimi yöneten bir iş parçacığından çağrılması, uygulamanın yanıt vermemeye başlamasına neden olabilir.

Bir uygulama AddPrintProvidor işlevini çağırmadan önce, sağlayıcı tarafından gereken tüm dosyaların SYSTEM32 dizinine kopyalanması gerekir.

AddPrintProvidor tarafından eklenen bir sağlayıcı DeletePrintProvidor çağrılarak kaldırılabilir.

Gereksinimler

Gereksinim	Değer
Desteklenen en düşük düzeydeki istemci	Windows 2000 Professional [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows 2000 Server [yalnızca masaüstü uygulamaları]
Başlık	Winspool.h (Windows.h dahil)
Kütüphane	Winspool.lib
DLL	Winspool.drv
Unicode ve ANSI adları	AddPrintProvidorW (Unicode) ve AddPrintProvidorA (ANSI)

Ayrıca bkz.

Yazdırma

Yazdırma Biriktiricisi API İşlevleri

DeletePrintProvidor

PROVIDOR_INFO_1

PROVIDOR_INFO_2