CertRegisterPhysicalStore, fonction (wincrypt.h)

Article
08/27/2023

La fonction CertRegisterPhysicalStore ajoute un magasin physique à une collection de magasins système du Registre.

Syntaxe

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

Paramètres

[in] pvSystemStore

Collection de magasins système à laquelle le magasin physique est ajouté. Ce paramètre pointe vers une chaîne Unicode terminée par null ou vers une structure CERT_SYSTEM_STORE_RELOCATE_PARA . Pour plus d’informations sur l’utilisation de la structure et sur l’ajout d’un ServiceName ou computerName avant la chaîne de nom du magasin système, consultez CertRegisterSystemStore.

[in] dwFlags

Le mot haut du paramètre dwFlags spécifie l’emplacement du magasin système. Pour plus d’informations sur les indicateurs de mots hauts définis et l’ajout de ServiceName, UserNames et ComputerNames à la fin du nom du magasin système, consultez CertRegisterSystemStore.

Les indicateurs de mots bas suivants sont également définis et peuvent être combinés avec des indicateurs de mot élevé à l’aide d’une opération OR au niveau du bit.

Valeur	Signification
CERT_SYSTEM_STORE_RELOCATE_FLAG	Le magasin système n’est pas dans son emplacement de Registre par défaut et le paramètre pvSystemStore doit être un pointeur vers une structure CERT_SYSTEM_STORE_RELOCATE_PARA .
CERT_STORE_CREATE_NEW_FLAG	La fonction échoue si le magasin physique existe déjà à l’emplacement du magasin.

[in] pwszStoreName

Pointeur vers une chaîne Unicode qui nomme le magasin physique à ajouter à la collection de magasins système. Pour supprimer un magasin physique de la collection de magasins système, appelez la fonction CertUnregisterPhysicalStore .

[in] pStoreInfo

Pointeur vers une structure CERT_PHYSICAL_STORE_INFO qui fournit des informations de base sur le magasin physique.

[in] pvReserved

Réservé pour une utilisation ultérieure et doit être défini sur NULL.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincrypt.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll