CryptFreeOIDFunctionAddress-Funktion (wincrypt.h)

  • Artikel

Die CryptFreeOIDFunctionAddress-Funktion gibt ein von CryptGetOIDFunctionAddress oder CryptGetDefaultOIDFunctionAddress zurückgegebenes Handle frei, indem die Verweisanzahl für das Funktionshandle verringert wird. In einigen Fällen wird die der Funktion zugeordnete DLL-Datei entladen. Einzelheiten finden Sie unter "Hinweise".

Syntax

BOOL CryptFreeOIDFunctionAddress(
  [in] HCRYPTOIDFUNCADDR hFuncAddr,
  [in] DWORD             dwFlags
);

Parameter

[in] hFuncAddr

Handle der Funktion, die zuvor von einem Aufruf von CryptGetOIDFunctionAddress oder CryptGetDefaultOIDFunctionAddress abgerufen wurde.

[in] dwFlags

Für die zukünftige Verwendung reserviert und muss null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück.

Hinweise

Wenn die Verweisanzahl 0 ist und eine DLL für die freigegebene Funktion geladen wird, wird die DLL möglicherweise entladen. Wenn die DLL die DLLCanUnloadNow-Funktion exportiert, wird diese Funktion aufgerufen, und ihre Rückgabe wird überprüft. Ein S_FALSE von dieser Funktion zurückgegeben wird, bricht das Entladen der DLL zu diesem Zeitpunkt ab. Wenn die Funktion S_TRUE zurückgibt oder die DLL die DLLCanUnloadNow-Funktion nicht exportiert, wird ein Entladungsprozess gestartet. In diesem Fall wird das tatsächliche Entladen um 15 Sekunden verzögert. Wenn eine andere CryptFreeOIDFunctionAddress oder CryptGetDefaultOIDFunctionAddress , die die DLL erfordert, vor ablaufen der 15 Sekunden auftritt, wird der Prozess der verzögerten Entladung abgebrochen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h
Bibliothek Crypt32.lib
DLL Crypt32.dll

Weitere Informationen

CryptGetDefaultOIDFunctionAddress

CryptGetOIDFunctionAddress

DLLCanUnloadNow

OID-Unterstützungsfunktionen