CryptInstallDefaultContext-Funktion (wincrypt.h)
Syntax
BOOL CryptInstallDefaultContext(
[in] HCRYPTPROV hCryptProv,
[in] DWORD dwDefaultType,
[in] const void *pvDefaultPara,
[in] DWORD dwFlags,
[in] void *pvReserved,
[out] HCRYPTDEFAULTCONTEXT *phDefaultContext
);
Parameter
[in] hCryptProv
Das Handle des Kryptografiedienstanbieters, der als Standardkontext verwendet werden soll. Dieses Handle wird mithilfe der CryptAcquireContext-Funktion abgerufen.
[in] dwDefaultType
Gibt den Typ des zu installierenden Kontexts an. Dies muss einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Installiert den Standardanbieter, der zum Überprüfen eines einzelnen Zertifikatsignaturtyps verwendet wird.
Der parameter pvDefaultPara ist die Adresse einer NULL-beendeten ANSI-Zeichenfolge, die den Objektbezeichner des Zertifikatsignaturalgorithmus zum Installieren des Anbieters für z. B. szOID_OIWSEC_md5RSA enthält. Wenn der parameter pvDefaultParaNULL ist, wird der angegebene Anbieter verwendet, um alle Zertifikatsignaturen zu überprüfen. Der parameter pvDefaultPara kann nicht NULL sein, wenn das flag CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG festgelegt ist. |
|
Installiert den Standardanbieter, der zum Überprüfen mehrerer Zertifikatsignaturtypen verwendet wird.
Der parameter pvDefaultPara ist die Adresse einer CRYPT_DEFAULT_CONTEXT_MULTI_OID_PARA-Struktur , die ein Array von Objektbezeichnern enthält, die die Zertifikatsignaturalgorithmen identifizieren, für die der angegebene Anbieter installiert werden soll. |
[in] pvDefaultPara
Gibt das Objekt oder die Objekte an, für die der Standardkontextanbieter installiert werden soll. Das Format dieses Parameters hängt vom Inhalt des dwDefaultType-Parameters ab.
[in] dwFlags
Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Das durch den hCryptProv-Parameter angegebene Anbieterhandle wird automatisch freigegeben, wenn der Prozess oder thread endet. Wenn dieses Flag nicht angegeben ist, liegt es in der Verantwortung des Aufrufers, das Anbieterhandle mithilfe der CryptReleaseContext-Funktion freizugeben, wenn das Handle nicht mehr benötigt wird. Das Anbieterhandle wird nicht freigegeben, wenn die CryptUninstallDefaultContext-Funktion aufgerufen wird, bevor der Prozess oder Thread beendet wird. |
|
Der Anbieter gilt für alle Threads im Prozess. Wenn dieses Flag nicht angegeben ist, gilt der Anbieter nur für den aufrufenden Thread. Der parameter pvDefaultPara darf nicht NULL sein, wenn dieses Flag festgelegt ist. |
[in] pvReserved
Dieser Parameter ist für die zukünftige Verwendung reserviert.
[out] phDefaultContext
Die Adresse einer HCRYPTDEFAULTCONTEXT-Variable , die das Standardkontexthandle empfängt. Dieses Handle wird an die Funktion CryptUninstallDefaultContext übergeben, um den Standardkontextanbieter zu deinstallieren.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert nonzero (TRUE). Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE). Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
Hinweise
Die installierten Standardkontextanbieter sind stapelgeordnet. Daher beginnt das System bei der Suche nach einem Standardkontextanbieter mit dem zuletzt installierten Anbieter. Die Liste der Anbieter pro Thread wird vor der Liste der Anbieter pro Prozess durchsucht. Nachdem eine Übereinstimmung gefunden wurde, sucht das System nicht mehr nach anderen Übereinstimmungen.
Das installierte Anbieterhandle muss zur Verwendung verfügbar bleiben, bis CryptUninstallDefaultContext aufgerufen wird oder der Thread oder Prozess beendet wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincrypt.h |
| Bibliothek | Crypt32.lib |
| DLL | Crypt32.dll |