PxeProviderQueryIndex, fonction (wdspxe.h)

Retourne l’index du fournisseur spécifié dans la liste des fournisseurs inscrits.

Syntaxe

DWORD PXEAPI PxeProviderQueryIndex(
  [in]  LPCWSTR pszProviderName,
  [out] PULONG  puIndex
);

Paramètres

[in] pszProviderName

Nom convivial du fournisseur à partir de l’appel à la fonction PxeProviderRegister .

[out] puIndex

Adresse d’un ULONG qui recevra l’index du fournisseur.

Valeur retournée

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

Remarques

Si un fournisseur souhaite s’insérer dans la liste des fournisseurs inscrits dans un ordre spécifique (c’est-à-dire qu’il souhaite traiter les demandes du client avant ou après un certain fournisseur), il peut interroger l’index d’un autre fournisseur, puis utiliser l’index retourné pour décider de son propre emplacement.

Exemples

//
// Suppose Provider wants to handle requests after BINLSVC has rejected them.
//
dwError = PxeProviderQueryIndex(L"BINLSVC", &Index);

if (dwError == ERROR_SUCCESS)
{
 if (PxeProviderRegister(L"MYPROV",
                         L"C:\\MyDir\\MyProv.DLL",
                         PXE_REG_INDEX_BOTTOM,
                         Index + 1,              // Add after BINLSVC
                         &hKey) != ERROR_SUCCESS)
 {
  // Handle Error
 }
}

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

PxeProviderRegister

Fonctions serveur des services de déploiement Windows