PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER Rückruffunktion (wincrypt.h)

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER Rückruffunktion gibt Arbeitsspeicher für einen Objektbezeichner frei.

Syntax

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER PfnCryptObjectLocatorProviderFreeIdentifier;

void PfnCryptObjectLocatorProviderFreeIdentifier(
  [in, optional] LPVOID pPluginContext,
  [in]           PCRYPT_DATA_BLOB pIdentifier
)
{...}

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] pIdentifier

Zeiger auf den Puffer, der den Bezeichner enthält.

Rückgabewert

Keine

Bemerkungen

Die PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_FREE_IDENTIFIER-Funktion wird derzeit nur vom Sicherheitspaket Secure Channel (Schannel) aufgerufen. Diese Funktion kann aus einem der folgenden Gründe aufgerufen werden:

• Fehler beim Verarbeiten des von der PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET-Funktion zurückgegebenen Objekts.
• Das von PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET zurückgegebene Objekt wird nicht mehr benötigt.
• Ein aktualisiertes Objekt wurde abgerufen, und das ursprüngliche Objekt ist nicht mehr erforderlich.

Anforderungen

Weitere Informationen

CRYPT_OBJECT_LOCATOR_PROVIDER_TABLE

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_GET

PFN_CRYPT_OBJECT_LOCATOR_PROVIDER_INITIALIZE