WintrustGetDefaultForUsage-Funktion (wintrust.h)

  • Artikel

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
DWACTION_ALLOCANDFILL
 Weisen Sie Arbeitsspeicher zu, und füllen Sie die CRYPT_PROVIDER_DEFUSAGE Struktur, auf die der parameter psUsage verweist.
DWACTION_FREE
 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

Weitere Informationen

CRYPT_PROVIDER_DEFUSAGE

CRYPT_PROVIDER_REGDEFUSAGE

WintrustAddDefaultForUsage