NmrClientAttachProvider-Funktion (netioddk.h)

Die NmrClientAttachProvider Funktion fügt ein Clientmodul an ein Anbietermodul an.

Syntax

NTSTATUS NmrClientAttachProvider(
  [in]  HANDLE                 NmrBindingHandle,
  [in]  __drv_aliasesMem PVOID ClientBindingContext,
  [in]  const VOID             *ClientDispatch,
  [out] PVOID                  *ProviderBindingContext,
  [out] const VOID             **ProviderDispatch
);

Parameter

[in] NmrBindingHandle

Ein Handle, das vom NMR verwendet wird, um die Bindung zwischen dem Clientmodul und dem Anbietermodul darzustellen. Der NMR übergibt dieses Handle an das Clientmodul, wenn es die ClientAttachProvider- Rückruffunktion des Clientmoduls aufruft.

[in] ClientBindingContext

Ein Zeiger auf einen vom Aufrufer bereitgestellten Kontext für die Bindung zwischen dem Clientmodul und dem Anbietermodul. Das Clientmodul verwendet diesen Kontext, um den Status der Bindung nachzuverfolgen. Der Inhalt des Bindungskontexts des Clientmoduls ist für das Anbietermodul nicht transparent. Das Anbietermodul übergibt diesen Zeiger an das Clientmodul, wenn er einen der NPI- Rückruffunktionen des Clientmoduls aufruft, die den Bindungskontext des Clientmoduls erfordern. Das Clientmodul muss sicherstellen, dass dieser Kontext gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul an das Clientmodul angefügt ist.

[in] ClientDispatch

Ein Zeiger auf eine Konstante, die die Verteilertabelle NPI- Rückruffunktionen für das Clientmodul enthält. Das Clientmodul muss sicherstellen, dass diese Struktur gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul an das Clientmodul angefügt ist. Der Inhalt der Struktur ist NPI-spezifisch. Wenn der NPI keine Client-Dispatch-Tabellenstruktur definiert, muss das Clientmodul diesen Parameter auf NULL-festlegen.

[out] ProviderBindingContext

Ein Zeiger auf eine Variable, die einen Zeiger auf den Kontext des Anbietermoduls für die Bindung zwischen dem Clientmodul und dem Anbietermodul empfängt. Das Anbietermodul verwendet diesen Kontext, um den Status der Bindung nachzuverfolgen. Der Inhalt des Bindungskontexts des Anbietermoduls ist für das Clientmodul nicht transparent. Das Clientmodul übergibt diesen Zeiger an das Anbietermodul, wenn es eines der NPI-funktionen des Anbietermoduls aufruft, Funktionen, die den Bindungskontext des Anbietermoduls erfordern.

[out] ProviderDispatch

Ein Zeiger auf eine Variable, die einen Zeiger auf eine Struktur empfängt, die die Verteilertabelle enthält
NPI- Funktionen für das Anbietermodul. Der Inhalt der Struktur ist NPI-spezifisch.

Rückgabewert

Die NmrClientAttachProvider Funktion gibt einen der folgenden NTSTATUS-Codes zurück:

Bemerkungen

Ein Clientmodul ruft die NmrClientAttachProvider-Funktion aus der ClientAttachProvider- Rückruffunktion auf, um sich an ein Anbietermodul anzufügen.

Wenn ein Clientmodul die NmrClientAttachProvider-Funktion aufruft, ruft nmR die ProviderAttachClient- Rückruffunktion des Anbietermoduls auf, um den Anlagenvorgang abzuschließen. Die NmrClientAttachProvider-Funktion gibt den Statuscode zurück, der von der ProviderAttachClient- Rückruffunktion des Anbietermoduls zurückgegeben wird.

Wenn die NmrClientAttachProvider--Funktion nicht STATUS_SUCCESS zurückgibt, sollte das Clientmodul alle erforderlichen Bereinigungen der In der Bindungskontextstruktur enthaltenen Daten ausführen. Das Clientmodul sollte dann den Speicher für seine Bindungskontextstruktur freigeben, wenn er den Speicher für die Struktur dynamisch zugewiesen hat.

Wenn die NmrClientAttachProvider--Funktion STATUS_SUCCESS zurückgibt und das Clientmodul den Speicher für den Bindungskontext dynamisch zugewiesen hat, sollte das Clientmodul den zugeordneten Speicher freigeben, wenn nmR das Clientmodul aufruft. ClientCleanupBindingContext Rückruffunktion, nachdem das Clientmodul und das Anbietermodul voneinander getrennt sind.

Wenn die NmrClientAttachProvider--Funktion STATUS_SUCCESS zurückgibt, muss das Clientmodul die in der ProviderBindingContext- zurückgegebenen Zeiger und ProviderDispatch Parameter speichern, sodass sie die NPI--Funktionen des Anbietermoduls aufrufen kann.

Anforderungen

Siehe auch

ClientAttachProvider-

ClientCleanupBindingContext-

ProviderAttachClient-