Funzione StrongNameGetPublicKey

Articolo
08/11/2011

Ottiene la chiave pubblica da un coppia di chiavi pubblica/privata. La coppia di chiavi può essere fornita come nome del contenitore di chiavi all'interno di un provider del servizio di crittografia (CSP, Cryptographic Service Provider) oppure come insieme non elaborato di byte.

Questa funzione è deprecata in .NET Framework versione 4. Utilizzare il metodo ICLRStrongName::StrongNameGetPublicKey.

BOOLEAN StrongNameGetPublicKey ( 
    [in]  LPCWSTR   szKeyContainer,
    [in]  BYTE      *pbKeyBlob,
    [in]  ULONG     cbKeyBlob,
    [out] BYTE      **ppbPublicKeyBlob,
    [out] ULONG     *pcbPublicKeyBlob
);

Parametri

szKeyContainer
[in] Nome del contenitore di chiavi contenente la coppia di chiavi pubblica/privata. Se il parametro pbKeyBlob è null, il parametro szKeyContainer deve specificare un contenitore valido all'interno di CSP. In questo caso, StrongNameGetPublicKey estrae la chiave pubblica dalla coppia di chiavi archiviata nel contenitore.

Se il parametro pbKeyBlob non è null, si presuppone che la coppia di chiavi sia contenuta nell'oggetto BLOB (Binary Large Object) della chiave.

Le chiavi devono essere costituite da chiavi di firma RSA (Rivest-Shamir-Adleman) a 1024 bit. Attualmente non sono supportati altri tipi di chiavi.
pbKeyBlob
[in] Puntatore alla coppia di chiavi pubblica/privata. Il formato di questa coppia corrisponde a quello creato dalla funzione Win32 CryptExportKey. Se il parametro pbKeyBlob è null, si presuppone che la coppia di chiavi sia archiviata nel contenitore di chiavi specificato dal parametro szKeyContainer.
cbKeyBlob
[in] Dimensione, in byte, di pbKeyBlob.
ppbPublicKeyBlob
[out] Oggetto BLOB della chiave pubblica restituito. Il parametro ppbPublicKeyBlob viene allocato da Common Language Runtime e restituito al chiamante, Il chiamante deve liberare la memoria utilizzando la funzione StrongNameFreeBuffer.
pcbPublicKeyBlob
[out] Dimensione dell'oggetto BLOB della chiave pubblica restituito.

Valore restituito

true in caso di esito positivo; in caso contrario, false.

Note

La chiave pubblica è contenuta in una struttura PublicKeyBlob.

Se la funzione StrongNameGetPublicKey non viene completata correttamente, chiamare la funzione StrongNameErrorInfo per recuperare l'ultimo errore generato.