NPI_CLIENT_ATTACH_PROVIDER_FN Rückruffunktion (netioddk.h)
Die ClientAttachProvider-Rückruffunktion eines Clientmoduls fügt das Clientmodul an ein Anbietermodul an.
NPI_CLIENT_ATTACH_PROVIDER_FN NpiClientAttachProviderFn;
NTSTATUS NpiClientAttachProviderFn(
[in] HANDLE NmrBindingHandle,
[in] PVOID ClientContext,
[in] PNPI_REGISTRATION_INSTANCE ProviderRegistrationInstance
)
{...}
[in] NmrBindingHandle
Ein Handle, das vom NMR verwendet wird, um die Bindung zwischen dem Clientmodul und dem Anbietermodul darzustellen.
[in] ClientContext
Ein Zeiger auf den Registrierungskontext des Clientmoduls. Das Clientmodul übergibt diesen Zeiger an den NMR, wenn es die NmrRegisterClient-Funktion aufruft, um sich beim NMR zu registrieren.
[in] ProviderRegistrationInstance
Ein Zeiger auf einen NPI_REGISTRATION_INSTANCE Struktur. Diese Struktur enthält die Registrierungsdaten des Anbietermoduls.
Die ClientAttachProvider-Rückruffunktion eines Clientmoduls gibt einen der folgenden NTSTATUS-Codes zurück:
Rückgabecode | Beschreibung |
---|---|
|
Das Clientmodul und das Anbietermodul wurden erfolgreich miteinander verknüpft. |
|
Entweder wurde das Clientmodul nicht an das Anbietermodul angefügt, oder das Anbietermodul wurde nicht an das Clientmodul angefügt. |
|
Ein Fehler ist aufgetreten. |
Nachdem ein Clientmodul beim NMR registriert wurde, ruft der NMR die ClientAttachProvider-Rückruffunktion des Clientmoduls einmal für jedes Anbietermodul auf, das als Anbieter derselben NPI registriert ist, für die das Clientmodul als Client registriert ist.
Der NMR ruft auch die ClientAttachProvider-Rückruffunktion eines Clientmoduls auf, wenn ein neues Netzwerkmodul als Anbieter desselben NPI registriert wird, für den das Clientmodul als Client registriert ist.
Ein Clientmodul kann die Registrierungsdaten des Anbietermoduls untersuchen. Diese Daten befinden sich in der Struktur, auf die der Parameter ProviderRegistrationInstance verweist. Das Clientmodul verwendet diese Daten, um zu bestimmen, ob es an das Anbietermodul angefügt wird:
- Wenn das Clientmodul feststellt, dass es an das Anbietermodul angefügt wird, ruft die ClientAttachProvider-Rückruffunktion die NmrClientAttachProvider-Funktion auf, um den Anlageprozess fortzusetzen. In dieser Situation muss die ClientAttachProvider-Rückruffunktion den status Code zurückgeben, der vom Aufruf des zurückgegeben wird. NmrClientAttachProvider-Funktion .
- Wenn das Clientmodul feststellt, dass es nicht an das Anbietermodul angefügt wird, muss die ClientAttachProvider-Rückruffunktion STATUS_NOINTERFACE zurückgeben.
Der NMR ruft die ClientAttachProvider-Rückruffunktion eines Clientmoduls unter IRQL = PASSIVE_LEVEL auf.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Zielplattform | Windows |
Kopfzeile | netioddk.h (einschließen von Wsk.h) |
IRQL | PASSIVE_LEVEL |