Funzione CryptRegisterOIDInfo (wincrypt.h)

Articolo
03/03/2024

La funzione CryptRegisterOIDInfo registra le informazioni OID specificate nella struttura CRYPT_OID_INFO , mantenendola nel Registro di sistema.

Crypt32.dll contiene informazioni predefinite per gli OID noti. Questa funzione consente alle applicazioni di aumentare le informazioni OID predefinite. Durante la prima chiamata di CryptRegisterOIDInfo, vengono installate le informazioni OID registrate.

Quando si espandono le tabelle usando CryptRegisterOIDInfo, le nuove voci possono essere inserite prima o dopo le voci predefinite controllate da dwFlags. Il posizionamento delle informazioni OID registrate influisce sul risultato di CryptFindOIDInfo perché le tabelle vengono cercate in ordine. Vengono controllate le voci registrate prima che vengano controllate le voci predefinite, quindi vengono controllate le voci predefinite e infine le voci registrate inserite dopo la verifica delle voci predefinite. Viene restituita la prima corrispondenza trovata. Una voce appena registrata viene inserita prima che le voci predefinite possano eseguire l'override di una delle voci predefinite.

Sintassi

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

Parametri

[in] pInfo

Puntatore a una struttura CRYPT_OID_INFO con le informazioni OID da registrare. Specificare il gruppo per cui devono essere registrate le informazioni OID impostando il membro dwGroupId della struttura.

Nota

Quando si registrano informazioni OID per gli algoritmi Suite B implementati con l'API di crittografia: Next Generation (CNG), è necessario impostare il membro Algid della struttura CRYPT_OID_INFO su CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

Per impostazione predefinita, le informazioni OID registrate vengono installate dopo le voci OID di Crypt32.dll. Se CRYPT_INSTALL_OID_INFO_BEFORE_FLAG è impostato, le nuove informazioni OID vengono installate prima delle voci di Crypt32.dll.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE).

Commenti

Al termine dell'uso delle informazioni OID, annullare la registrazione chiamando la funzione CryptUnregisterOIDInfo .

Requisiti

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