Funzione CertRegisterPhysicalStore (wincrypt.h)

Articolo
08/27/2023

La funzione CertRegisterPhysicalStore aggiunge un archivio fisico a una raccolta di archivi di sistema del Registro di sistema.

Sintassi

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

Parametri

[in] pvSystemStore

Raccolta dell'archivio di sistema a cui viene aggiunto l'archivio fisico. Questo parametro punta a una stringa Unicode con terminazione Null o a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA . Per informazioni sull'uso della struttura e sull'aggiunta di un NomeServizio o ComputerName prima della stringa del nome dell'archivio di sistema, vedere CertRegisterSystemStore.

[in] dwFlags

La parola alta del parametro dwFlags specifica la posizione dell'archivio di sistema. Per informazioni sui flag ad alta parola definiti e sull'aggiunta di ServiceName, UserNames e ComputerNames alla fine del nome dell'archivio di sistema, vedere CertRegisterSystemStore.

Vengono definiti anche i flag a parole basse seguenti e possono essere combinati con flag con parole elevate usando un'operazione OR bit per bit.

Valore	Significato
CERT_SYSTEM_STORE_RELOCATE_FLAG	L'archivio di sistema non si trova nel percorso predefinito del Registro di sistema e il parametro 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 fisico esiste già nella posizione dell'archivio.

[in] pwszStoreName

Puntatore a una stringa Unicode che assegna un nome all'archivio fisico da aggiungere alla raccolta di archivi di sistema. Per rimuovere un archivio fisico dalla raccolta di archivi di sistema, chiamare la funzione CertUnregisterPhysicalStore .

[in] pStoreInfo

Puntatore a una struttura di CERT_PHYSICAL_STORE_INFO che fornisce informazioni di base sull'archivio fisico.

[in] pvReserved

Riservato per 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.

Requisiti


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