WintrustGetDefaultForUsage-Funktion (wintrust.h)
Die WintrustGetDefaultForUsage-Funktion ruft die Standardverwendungs-ID und Rückrufinformationen ab.
Syntax
BOOL WintrustGetDefaultForUsage(
[in] DWORD dwAction,
[in] const char *pszUsageOID,
[in, out] CRYPT_PROVIDER_DEFUSAGE *psUsage
);
Parameter
[in] dwAction
Auszuführende Aktion. Dies kann einer der folgenden Werte sein. Weitere Informationen finden Sie in den Hinweisen.
| Wert | Bedeutung |
|---|---|
|
Weisen Sie Arbeitsspeicher zu, und füllen Sie die CRYPT_PROVIDER_DEFUSAGE Struktur, auf die der parameter psUsage verweist. |
|
Geben Sie den gesamten Arbeitsspeicher frei, der während eines vorherigen Aufrufs dieser Funktion zugewiesen wurde, indem Sie DWACTION_ALLOCANDFILL für diesen Parameter angeben. |
[in] pszUsageOID
Zeiger auf eine Zeichenfolge, die den Bezeichner enthält.
[in, out] psUsage
Zeiger auf eine CRYPT_PROVIDER_DEFUSAGE-Struktur , die Rückrufinformationen enthält, die abgerufen werden sollen.
Rückgabewert
Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. FALSE , wenn die Funktion fehlschlägt. Wenn die Funktion fehlschlägt, rufen Sie die GetLastError-Funktion auf, um die Ursache für den Fehler zu ermitteln.
Hinweise
Rufen Sie diese Funktion einmal auf, wobei der dwAction-Parameter auf DWACTION_ALLOCANDFILL festgelegt ist, um Arbeitsspeicher zuzuweisen und eine CRYPT_PROVIDER_DEFUSAGE-Struktur mit Informationen zu füllen. Rufen Sie diese Funktion erneut auf, wobei der dwAction-Parameter auf DWACTION_FREE festgelegt ist, um den zugeordneten Arbeitsspeicher freizugeben.
Die Standardnutzungs- und Rückrufinformationen für einen Anbieter werden durch Aufrufen der WintrustAddDefaultForUsage-Funktion registriert.
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 | wintrust.h |
| Bibliothek | Wintrust.lib |
| DLL | Wintrust.dll |