Funzione CryptFreeOIDFunctionAddress (wincrypt.h)

  • Articolo

La funzione CryptFreeOIDFunctionAddress rilascia un handle restituito da CryptGetOIDFunctionAddress o CryptGetDefaultOIDFunctionAddress decrementando il conteggio dei riferimenti nell'handle della funzione. In alcuni casi, il file DLL associato alla funzione viene scaricato. Per informazioni dettagliate, vedere la sezione Osservazioni.

Sintassi

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

Parametri

[in] hFuncAddr

Handle della funzione ottenuta in precedenza da una chiamata a CryptGetOIDFunctionAddress o CryptGetDefaultOIDFunctionAddress.

[in] dwFlags

Riservato per uso futuro e deve essere zero.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero (TRUE).

Se la funzione non riesce, restituisce zero (FALSE).

Commenti

Se il conteggio dei riferimenti diventa zero e viene caricata una DLL per la funzione liberata, la DLL potrebbe essere scaricata. Se la DLL esporta la funzione DLLCanUnloadNow , tale funzione viene chiamata e viene verificata la relativa restituzione. Un S_FALSE restituito da questa funzione annulla lo scaricamento della DLL in questo momento. Se la funzione restituisce S_TRUE o se la DLL non esporta la funzione DLLCanUnloadNow , viene avviato un processo di scaricamento. In questo caso, lo scaricamento effettivo viene posticipato per 15 secondi. Se un altro CryptFreeOIDFunctionAddress o CryptGetDefaultOIDFunctionAddress che richiede che la DLL venga eseguita prima della scadenza dei 15 secondi, il processo di scaricamento posticipato viene annullato.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

CryptGetDefaultOIDFunctionAddress

CryptGetOIDFunctionAddress

Dllcanunloadnow

Funzioni di supporto OID