RxSetSrvCallDomainName-Funktion (rxprocs.h)
RxSetSrvCallDomainName wird von einem Netzwerk-Miniumleitungstreiber aufgerufen, um den domänennamen festzulegen, der einem bestimmten Server (SRV_CALL Struktur) zugeordnet ist.
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 mit Null beendete Unicode-Zeichenfolge 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 für Fehler zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Es gab nicht genügend Ressourcen, um diese Routine abzuschließen. Fehler bei der Speicherzuweisungsanforderung für nicht seitenseitigen Poolspeicher zum Speichern des neuen Domänennamens. |
Bemerkungen
Der Domänenname ist möglicherweise am Anfang einer Netzwerkumleitungsanforderung nicht bekannt. Die RxSetSrvCallDomainName Routine ermöglicht die Zuordnung des Domänennamens SrvCall, sobald sie bekannt ist. Diese Routine wird normalerweise als Teil der Erstellung und Initialisierung einer SRV_CALL Struktur verwendet.
Wenn bereits ein Domänenname dem parameter SrvCall zugeordnet ist, wird dieser Domänenname entfernt, und der diesem Eintrag in SrvCall zugeordnete Speicher wird freigegeben.
Wenn der parameter DomainName kein NULL- Zeiger ist und der parameter DomainName eine Länge größer als 0 hat, weist RxSetSrvCallDomainName Speicherplatz für das pDomainName Member von SrvCall aus einem nicht seitenseitigen Pool mit einem Pooltag von RX_SRVCALL_PARAMS_POOLTAG zu. Die RxSetSrvCallDomainName Routine legt den Puffer, Längeund MaximumLength Member der pDomainName Struktur fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | rxprocs.h (einschließlich Mrxfcb.h, Rxprocs.h) |
| IRQL- | <= APC_LEVEL |