CryptSetProviderA-Funktion (wincrypt.h)

Artikel
11/20/2024

Wichtige Diese API ist veraltet. Neue und vorhandene Software sollten mit der Verwendung Kryptografie-APIs der nächsten Generation beginnen. Microsoft kann diese API in zukünftigen Versionen entfernen.

Die CryptSetProvider--Funktion gibt den standardmäßigen kryptografischen Dienstanbieter (CSP) des aktuellen Benutzers an.

Wenn der Standardanbieter eines aktuellen Benutzers festgelegt ist, wird dieser Standardanbieter von jedem Aufruf dieses Benutzers abgerufen , um CryptAcquireContext einen dwProvType Anbietertyp, aber keinen CSP-Namen anzugeben.

Eine erweiterte Version dieser Funktion, CryptSetProviderEx, ist ebenfalls verfügbar.

Hinweis Typische Anwendungen verwenden diese Funktion nicht. Sie ist ausschließlich für administrative Anwendungen vorgesehen.

Syntax

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

Parameter

[in] pszProvName

Name des neuen Standard-CSP. Der benannte CSP muss auf dem Computer installiert sein. Eine Liste der verfügbaren kryptografischen Anbieter finden Sie unter Kryptografieanbieternamen.

[in] dwProvType

Anbietertyp des durch pszProvNameangegebenen CSP.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert null (FALSE). Rufen Sie für erweiterte Fehlerinformationen GetLastError-auf. Einige mögliche Fehlercodes sind in der folgenden Tabelle aufgeführt.

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Einer der Parameter gibt ein ungültiges Handle an.
ERROR_INVALID_PARAMETER	Einer der Parameter enthält einen ungültigen Wert. Dies ist am häufigsten ein ungültiger Zeiger.
ERROR_NOT_ENOUGH_MEMORY	Das Betriebssystem hat während des Vorgangs nicht genügend Arbeitsspeicher.

Fehler können auch von internen Aufrufen an RegCreateKeyEx- und RegSetValueEx-weitergegeben werden.

Bemerkungen

Typische Anwendungen geben beim Aufrufen CryptAcquireContextkeinen CSP-Namen an; Eine Anwendung hat jedoch die Möglichkeit, einen bestimmten CSP auszuwählen. Dadurch erhält ein Benutzer die Freiheit, einen CSP mit einer angemessenen Sicherheitsstufe auszuwählen.

Da der Aufruf von CryptSetProvider den CSP eines angegebenen Typs bestimmt, der von allen Anwendungen verwendet wird, die von diesem Zeitpunkt an ausgeführt werden, darf diese Funktion nicht ohne Zustimmung des Benutzers aufgerufen werden.

Anmerkung

Der wincrypt.h-Header definiert CryptSetProvider als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincrypt.h
Library	Advapi32.lib
DLL-	Advapi32.dll

Siehe auch

CryptAcquireContext-

Kryptografieanbieternamen

RegCreateKeyEx-

RegSetValueEx-

Dienstanbieterfunktionen

Freigeben über