Funzione CertRegisterSystemStore (wincrypt.h)

Articolo
08/27/2023

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.

Valore	Significato
CERT_SYSTEM_STORE_CURRENT_SERVICE	pvSystemStore può essere un nome dell'archivio di sistema preceduto da ServiceName.
CERT_SYSTEM_STORE_CURRENT_USER	pvSystemStore può essere un nome dell'archivio di sistema preceduto da UserName.
CERT_SYSTEM_STORE_LOCAL_MACHINE	pvSystemStore può essere un archivio di sistema in un computer remoto.
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY	pvSystemStore è un archivio criteri di gruppo e può essere in un computer remoto.
CERT_SYSTEM_STORE_SERVICES	pvSystemStore deve essere un nome dell'archivio di sistema preceduto da ServiceName.
CERT_SYSTEM_STORE_USERS	pvSystemStore deve essere un nome dell'archivio di sistema preceduto da UserName.

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
CERT_SYSTEM_STORE_RELOCATE_FLAG	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 .
CERT_STORE_CREATE_NEW_FLAG	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