RxSetSrvCallDomainName-Funktion (rxprocs.h)

  • Artikel

RxSetSrvCallDomainName wird von einem Netzwerk-Miniumleitungstreiber aufgerufen, um den Domänennamen festzulegen, der einem bestimmten Server zugeordnet ist (SRV_CALL-Struktur).

Syntax

NTSTATUS RxSetSrvCallDomainName(
  [in] IN PMRX_SRV_CALL   SrvCall,
  [in] IN PUNICODE_STRING DomainName
);

Parameter

[in] SrvCall

Ein Zeiger auf die SRV_CALL-Struktur.

[in] DomainName

Ein Zeiger auf einen Puffer, der eine Unicode-Zeichenfolge mit Nullende enthält, die die Domäne benennt, zu der dieser Server gehört.

Rückgabewert

RxSetSrvCallDomainName gibt STATUS_SUCCESS bei Erfolg oder einen der folgenden Fehlerwerte bei Fehler zurück:

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
 Es gab nicht genügend Ressourcen, um diese Routine abzuschließen. Fehler bei der Speicherzuordnungsanforderung für nicht auslagerten Poolspeicher zum Speichern des neuen Domänennamens.The memory allocation request for nonpaged pool memory to speichern the new domain name.

Hinweise

Der Domänenname ist zu Beginn einer Netzwerkumleitungsanforderung möglicherweise nicht bekannt. Die RxSetSrvCallDomainName-Routine ermöglicht die Zuordnung des Domänennamens zu SrvCall , sobald er bekannt ist. Diese Routine wird normalerweise als Teil der Erstellung und Initialisierung einer SRV_CALL-Struktur verwendet.

Wenn dem SrvCall-Parameter bereits ein Domänenname zugeordnet ist, wird dieser Domänenname entfernt, und der diesem Eintrag in SrvCall zugeordnete Arbeitsspeicher wird freigegeben.

Wenn der DomainName-Parameter kein NULL-Zeiger ist und der DomainName-Parameter eine Länge größer als null hat, weist RxSetSrvCallDomainName Speicherplatz für das pDomainName-Element von SrvCall aus einem poolfremden Pool mit dem Pooltag RX_SRVCALL_PARAMS_POOLTAG zu. Die RxSetSrvCallDomainName-Routine legt die Elemente puffer, length und MaximumLength der pDomainName-Struktur fest.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile rxprocs.h (einschließlich Mrxfcb.h, Rxprocs.h)
IRQL <= APC_LEVEL

Weitere Informationen

RxCreateSrvCall

RxFinalizeSrvCall