PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD Rückruffunktion (wincrypt.h)

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD Rückruffunktion gibt das Kennwort frei, das zum Verschlüsseln eines PFX-Bytearrays (Personal Information Exchange) verwendet wird.

Syntax

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD PfnCryptObjectLocatorProviderFreePassword;

void PfnCryptObjectLocatorProviderFreePassword(
  [in, optional] LPVOID pPluginContext,
  [in]           PCWSTR pwszPassword
)
{...}

Parameter

[in, optional] pPluginContext

Zeiger auf einen optionalen Puffer, der von diesem Anbieter definiert und von der PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE-Funktion zurückgegeben wird. Der Puffer wird vom Aufrufer nicht geändert. Ihr Anbieter kann die Daten verwenden, um zu bestimmen, welche Aktionen ausgeführt werden sollen, oder um zusätzliche Informationen zu verwalten.

[in] pwszPassword

Unicode-Zeichenfolge mit Null-Endung, die das Kennwort enthält.

Rückgabewert

Keine

Bemerkungen

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD-Funktion wird derzeit nur vom Sicherheitspaket Secure Channel (Schannel) aufgerufen. Schannel ruft PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET auf, um ein PFX-Bytearray abzurufen, und ruft dann PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_PASSWORD auf, nachdem das Bytearray verarbeitet wurde, aber vor dem Aufrufen der PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER-Funktion .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h

Weitere Informationen

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE