Funzione CryptGetDefaultOIDFunctionAddress (wincrypt.h)

Articolo
03/03/2024

La funzione CryptGetDefaultOIDFunctionAddress carica la DLL che contiene un indirizzo di funzione predefinito. Può anche restituire l'indirizzo della funzione OID (Default Object Identifier ) del primo o successivo installato in un set di funzioni inizializzato e caricare la DLL che contiene l'indirizzo di tale funzione.

Sintassi

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

Parametri

[in] hFuncSet

Handle del set di funzioni ottenuto in precedenza da una chiamata a CryptInitOIDFunctionSet.

[in] dwEncodingType

Tipo di codifica di cui trovare la corrispondenza. Attualmente vengono usati solo X509_ASN_ENCODING e PKCS_7_ASN_ENCODING; Tuttavia, è possibile aggiungere altri tipi di codifica in futuro. Per trovare le corrispondenze con entrambi i tipi di codifica correnti, usare:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

[in, optional] pwszDll

Nome della DLL da caricare. In genere, il nome della DLL viene ottenuto dall'elenco restituito da CryptGetDefaultOIDDllList. Se pwszDll è NULL, viene eseguita una ricerca nell'elenco delle funzioni predefinite installate.

[in] dwFlags

Riservato per uso futuro e deve essere zero.

[out] ppvFuncAddr

Puntatore all'indirizzo della funzione restituita. Se la funzione ha esito negativo, viene restituito un valore NULL in ppvFuncAddr.

[in, out] phFuncAddr

Usato solo se pwszDll è NULL. Nella prima chiamata alla funzione *phFuncAddr deve essere NULL per acquisire la prima funzione installata.

Quando questa funzione ha esito positivo, *phFuncAddr è impostato su un handle di funzione. Il conteggio dei riferimenti per l'handle di funzione viene incrementato.

Dopo la prima chiamata alla funzione , phFuncAddr viene impostato sul puntatore restituito dalla chiamata precedente. Questo puntatore di input viene sempre liberato all'interno della funzione tramite una chiamata a CryptFreeOIDFunctionAddress da questa funzione. La chiamata a liberare il puntatore viene sempre eseguita anche quando la funzione main restituisce un errore.

Un phFuncAddr non NULL deve essere rilasciato tramite una chiamata a CryptFreeOIDFunctionAddress oppure passando di nuovo come input a questa funzione o come input a CryptGetOIDFunctionAddress.

Se pwszDll non è NULL, il valore di questo parametro viene ignorato e un puntatore non NULL non viene liberato.

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).

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

Funzioni di supporto OID

Condividi tramite