Funzione CertRegisterSystemStore (wincrypt.h)
La funzione CertRegisterSystemStore registra un archivio di sistema.
Sintassi
BOOL CertRegisterSystemStore(
[in] const void *pvSystemStore,
[in] DWORD dwFlags,
[in] PCERT_SYSTEM_STORE_INFO pStoreInfo,
[in] void *pvReserved
);
Parametri
[in] pvSystemStore
Identifica l'archivio di sistema da registrare. Se CERT_SYSTEM_STORE_RELOCATE_FLAG è impostato nel parametro dwFlags , pvSystemStore punta a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA . In caso contrario, punta a una stringa Unicode con terminazione null che denomina l'archivio di sistema.
Con le impostazioni appropriate in dwFlags, l'archivio identificato può essere un archivio di sistema in un computer locale remoto. Gli archivi nei computer remoti possono essere registrati con il nome del computer come prefisso al nome dell'archivio di sistema. Ad esempio, un archivio computer locale remoto può essere registrato con pvSystemStore che punta alla stringa "\ComputerName\Trust" o "ComputerName\Trust".
Le barre rovescie iniziali "\" sono facoltative prima di un Nome computer.
[in] dwFlags
La parola alta del parametro dwFlags viene usata per specificare il percorso dell'archivio di sistema.
I valori di parole elevate seguenti sono definiti.
Gli archivi nei computer remoti possono essere registrati per CERT_SYSTEM_STORE_LOCAL_MACHINE, CERT_SYSTEM_STORE_SERVICES, CERT_SYSTEM_STORE_USERS o CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY.
I valori a parole basse seguenti sono definiti anche e possono essere combinati usando un'operazione bit per bit-OR con valori di parola elevata.
| Valore | Significato |
|---|---|
|
L'archivio di sistema non si trova nel percorso di registrazione predefinito e pvSystemStore deve essere un puntatore a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA . |
|
La funzione ha esito negativo se l'archivio di sistema esiste già nel percorso dell'archivio. |
[in] pStoreInfo
Riservato per l'uso futuro e deve essere impostato su NULL.
[in] pvReserved
Riservato per l'uso futuro e deve essere impostato su NULL.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.
Se la funzione ha esito negativo, restituisce zero.
Commenti
Per annullare la registrazione di un archivio di sistema registrato da questa funzione, chiamare CertUnregisterSystemStore.
Esempio
Nell'esempio seguente viene illustrato l'aggiunta di un archivio di sistema a una raccolta di archivi di sistema del Registro di sistema. Per un esempio che include il contesto completo per questo esempio, vedere Esempio di programma C: Presentazione di archivi fisici e di sistema.
//--------------------------------------------------------------------
// Declare and initialize variables.
LPCWSTR pvSystemName= L"NEWSTORE"; // For this setting of
// dwFlags, the store name may
// be prefixed with a user name.
DWORD dwFlags= CERT_SYSTEM_STORE_CURRENT_USER;
if(CertRegisterSystemStore(
pvSystemName,
dwFlags,
NULL,
NULL))
{
printf("System store %S is registered. \n",pvSystemName);
}
else
{
printf("The system store did not register. \n");
exit(1);
}
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 |