PxeProviderRegister, fonction (wdspxe.h)

Article
03/03/2024

Inscrit un fournisseur auprès du système. Les fournisseurs utilisent cette fonction pendant l’installation pour s’inscrire auprès du système. Une fois l’inscription réussie, un handle de clé de Registre qui doit être utilisé pour stocker les informations de configuration est retourné.

Syntaxe

DWORD PXEAPI PxeProviderRegister(
  [in]  LPCWSTR       pszProviderName,
  [in]  LPCWSTR       pszModulePath,
  [in]  PXE_REG_INDEX Index,
  [in]  BOOL          bIsCritical,
  [out] PHKEY         phProviderKey
);

Paramètres

[in] pszProviderName

Adresse d’une chaîne terminée par null qui spécifie le nom complet du fournisseur. Ce nom est affiché à l’utilisateur et doit être unique parmi les fournisseurs inscrits.

[in] pszModulePath

Adresse d’une chaîne terminée par null qui spécifie le chemin d’accès complet à la DLL du fournisseur.

[in] Index

Indexez dans la liste des fournisseurs. Tous les fournisseurs existants sont déplacés vers le bas si nécessaire. L’administrateur peut réorganiser les fournisseurs en fonction des besoins, de sorte qu’aucune hypothèse ne doit être faite concernant l’ordre des fournisseurs.

Valeur	Signification
PXE_REG_INDEX_TOP 0	Ajoutez le fournisseur en haut de la liste pour être le premier à recevoir des demandes client.
PXE_REG_INDEX_BOTTOM 0xFFFFFFFF	Ajoutez le fournisseur au bas de la liste.

[in] bIsCritical

Indique si le fournisseur est critique. En cas de défaillance d’un fournisseur critique, le serveur WDS échoue également.

[out] phProviderKey

Adresse d’une clé HKEY où la configuration doit être stockée. Le fournisseur reçoit un handle pour cette même clé que le paramètre hProviderKey à son rappel PxeProviderInitialize .

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wdspxe.h
Bibliothèque	WdsPxe.lib
DLL	WdsPxe.dll

Voir aussi

PxeProviderInitialize

PxeProviderUnRegister

Fonctions serveur des services de déploiement Windows

Share via