Funzione PxeProviderQueryIndex (wdspxe.h)

  • Articolo

Restituisce l'indice del provider specificato nell'elenco dei provider registrati.

Sintassi

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

Parametri

[in] pszProviderName

Nome descrittivo per il provider dalla chiamata alla funzione PxeProviderRegister .

[out] puIndex

Indirizzo di una ULONG che riceverà l'indice del provider.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Commenti

Se un provider vuole inserire se stesso nell'elenco dei provider registrati in un ordine specifico, ovvero vuole gestire le richieste client prima o dopo un determinato provider, può eseguire una query sull'indice di un altro provider e quindi usare l'indice restituito per decidere la propria posizione.

Esempio

//
// 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
 }
}

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008, Windows Server 2003 con SP2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wdspxe.h
Libreria WdsPxe.lib
DLL WdsPxe.dll

Vedi anche

PxeProviderRegister

Funzioni del server di Servizi di distribuzione Windows