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 |