Funzione PxeProviderRegister (wdspxe.h)

Registra un provider con il sistema. I provider usano questa funzione durante l'installazione per la registrazione nel sistema. Al termine della registrazione, viene restituito un handle di chiave del Registro di sistema che deve essere usato per archiviare le informazioni di configurazione.

Sintassi

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

Parametri

[in] pszProviderName

Indirizzo di una stringa con terminazione Null che specifica il nome visualizzato del provider. Questo nome viene visualizzato all'utente e deve essere univoco tra i provider registrati.

[in] pszModulePath

Indirizzo di una stringa con terminazione Null che specifica il percorso completo della DLL del provider.

[in] Index

Indicizzare nell'elenco dei provider. Se necessario, tutti i provider esistenti vengono spostati verso il basso. L'amministratore può riorganizzare i provider in base alle esigenze, quindi non è necessario fare ipotesi sull'ordine dei provider.

Valore	Significato
PXE_REG_INDEX_TOP 0	Aggiungere il provider all'inizio dell'elenco in modo che sia il primo a ricevere le richieste client.
PXE_REG_INDEX_BOTTOM 0xffffffff	Aggiungere il provider nella parte inferiore dell'elenco.

[in] bIsCritical

Indica se il provider è critico. Se un provider critico ha esito negativo, anche il server WDS avrà esito negativo.

[out] phProviderKey

Indirizzo di un HKEY in cui deve essere archiviata la configurazione. Il provider riceverà un handle per questa stessa chiave del parametro hProviderKey per il callback PxeProviderInitialize .

Valore restituito

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

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

PxeProviderInitialize

PxeProviderUnRegister

Funzioni del server di Servizi di distribuzione Windows