Funzione CryptRegisterOIDInfo (wincrypt.h)
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.
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 |