PeerGroupImportDatabase, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupImportDatabase importe une base de données de groupe d’homologues à partir d’un fichier local.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupImportDatabase(
  [in] HGROUP hGroup,
  [in] PCWSTR pwzFilePath
);

Paramètres

[in] hGroup

Gérez vers un groupe d’homologues dont la base de données est importée à partir d’un fichier local. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pwzFilePath

Pointeur vers une chaîne Unicode qui contient le chemin d’accès absolu du système de fichiers et le nom de fichier où les données sont stockées, par exemple, « C :\backup\p2pdb.db ». Si le fichier n’existe pas à cet emplacement, une erreur appropriée du système de fichiers est retournée. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Note Si une importation échoue en raison d’une erreur de système de fichiers, l’erreur de système de fichiers appropriée est retournée.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
PEER_E_GROUP_IN_USE	Impossible d’effectuer l’opération, car la base de données de groupe d’homologues est en cours d’utilisation. Par exemple, PeerGroupConnect a été appelé par un homologue, mais n’a pas encore effectué de transactions de base de données.
PEER_E_INVALID_GROUP	Le handle du groupe d’homologues n’est pas valide.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Remarques

Cette fonction doit être appelée avant PeerGroupConnect et après PeerGroupOpen ou PeerGroupJoin.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll