struttura CERT_PHYSICAL_STORE_INFO (wincrypt.h)
La struttura CERT_PHYSICAL_STORE_INFO contiene informazioni sugli archivi certificati fisici. Alcuni membri di queste strutture vengono passati direttamente alle chiamate di sistema di CertOpenStore per aprire l'archivio fisico.
Sintassi
typedef struct _CERT_PHYSICAL_STORE_INFO {
DWORD cbSize;
LPSTR pszOpenStoreProvider;
DWORD dwOpenEncodingType;
DWORD dwOpenFlags;
CRYPT_DATA_BLOB OpenParameters;
DWORD dwFlags;
DWORD dwPriority;
} CERT_PHYSICAL_STORE_INFO, *PCERT_PHYSICAL_STORE_INFO;
Members
cbSize
Dimensione, in byte, della struttura.
pszOpenStoreProvider
Puntatore a una stringa che assegna un nome a un tipo di provider dell'archivio certificati . Questa stringa viene passata in una chiamata di sistema a CertOpenStore e determina il tipo di provider di un archivio certificati da aprire. Per i nomi dei tipi di archivio certificati predefiniti, vedere CertOpenStore.
Oltre ai tipi di provider dell'archivio certificati predefiniti, è possibile installare e registrare nuovi tipi di provider di archivi con CryptInstallOIDFunctionAddress o CryptRegisterOIDFunction. Per altre informazioni, vedere CertOpenStore.
dwOpenEncodingType
Questo membro è applicabile solo quando CERT_STORE_PROV_MSG, CERT_STORE_PROV_PKCS7 o CERT_STORE_PROV_FILENAME viene passato in lpszStoreProvider. In caso contrario, questo membro non viene usato.
È sempre accettabile specificare sia i tipi di codifica del certificato che dei messaggi combinandoli con un'operazione bit per bit or , come illustrato nell'esempio seguente:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Tipi di codifica attualmente definiti sono:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
dwOpenFlags
Se un archivio di sistema viene aperto con il percorso dell'archivio SERVICES o USERS, il percorso dell'archivio dwOpenFlags è impostato su CERT_SYSTEM_STORE_USERS o CERT_SYSTEM_STORE_SERVICES.
OpenParameters
CRYPT_DATA_BLOB che contiene dati da passare al parametro pvPara della funzione CertOpenStore. Il tipo di dati dipende dal provider specificato. Per informazioni dettagliate sul tipo e sul contenuto da passare, vedere le descrizioni dei provider disponibili in CertOpenStore.
dwFlags
I valori dwFlags seguenti per CERT_PHYSICAL_STORE_INFO sono definiti.
| Valore | Significato |
|---|---|
|
Consente di aggiungere un contesto all'archivio. |
|
Impostato dalla funzione CertRegisterPhysicalStore . Per impostazione predefinita, tutti gli archivi di sistema presenti nel Registro di sistema dispongono di un archivio fisico SystemRegistry implicito aperto. Per disabilitare l'apertura di questo archivio, l'archivio fisico SystemRegistry corrispondente all'archivio di sistema deve essere registrato impostando CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG o registrando un archivio fisico denominato ". Impostazione predefinita" con CertRegisterPhysicalStore. |
|
Disabilita l'apertura remota dell'archivio fisico. |
|
Places la stringa \\ComputerName davanti ad altri tipi di provider. |
|
Consente a CertOpenStore di aprire un archivio relativo a un HKEY specificato dall'utente anziché a una delle costanti HKEY predefinite. Ad esempio, HKEY_CURRENT_USER può essere sostituito con un HKEY specificato dall'utente. Quando CERT_SYSTEM_STORE_RELOCATE_FLAG è impostato, il parametro pvPara passato a CertOpenStore punta a una struttura CERT_SYSTEM_STORE_RELOCATE_PARA anziché puntare al nome dell'archivio come stringa Unicode o ASCII con terminazione null. |
dwPriority
Quando viene aperto un archivio di sistema, i relativi archivi fisici vengono ordinati in base alle impostazioni di dwPriority . Una dwPriority superiore indica una priorità superiore. Il membro dwPriority viene passato a CertAddStoreToCollection.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | wincrypt.h |