struttura CERT_PHYSICAL_STORE_INFO (wincrypt.h)

  • Articolo

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
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG
 Consente di aggiungere un contesto all'archivio.
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG
 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.
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG
 Disabilita l'apertura remota dell'archivio fisico.
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG
 Places la stringa \\ComputerName davanti ad altri tipi di provider.
CERT_SYSTEM_STORE_RELOCATE_FLAG
 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

Vedi anche

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction