CryptSetProviderExA-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 CryptSetProviderEx--Funktion gibt den standardmäßigen kryptografischen Dienstanbieter (CSP) eines angegebenen Anbietertyps für den lokalen Computer oder aktuellen Benutzer an.

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

Syntax

BOOL CryptSetProviderExA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType,
  [in] DWORD  *pdwReserved,
  [in] DWORD  dwFlags
);

Parameter

[in] pszProvName

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

[in] dwProvType

Der Anbietertyp des durch pszProvNameangegebenen CSP.

[in] pdwReserved

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss NULL-sein.

[in] dwFlags

Die folgenden Flagwerte werden definiert.

Wert	Bedeutung
CRYPT_DELETE_DEFAULT 0x00000004	Kann in Verbindung mit CRYPT_MACHINE_DEFAULT oder CRYPT_USER_DEFAULT verwendet werden, um den Standardwert zu löschen.
CRYPT_USER_DEFAULT 0x00000002	Bewirkt, dass der Standard-CSP für den Benutzerkontext des angegebenen Typs festgelegt wird.
CRYPT_MACHINE_DEFAULT 0x00000001	Bewirkt, dass der Computerstandard-CSP des angegebenen Typs festgelegt wird.

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. Mögliche Fehlercodes sind die in der folgenden Tabelle aufgeführten Fehlercodes.

Rückgabecode	Beschreibung
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 nicht genügend Arbeitsspeicher.

Bemerkungen

Die meisten Anwendungen geben keinen CSP-Namen beim Aufrufen der CryptAcquireContext--Funktion an; Eine Anwendung kann jedoch einen CSP-Namen angeben und damit einen CSP mit einer geeigneten Sicherheitsstufe auswählen. Da Aufrufe von CryptSetProviderEx den CSP eines angegebenen Typs bestimmen, der von allen Anwendungen verwendet wird, darf CryptSetProviderEx niemals ohne Zustimmung eines Benutzers aufgerufen werden.

Anmerkung

Der wincrypt.h-Header definiert CryptSetProviderEx 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-

CryptSetProvider-

Dienstanbieterfunktionen

Freigeben über