RxSetSrvCallDomainName-Funktion (rxprocs.h)

RxSetSrvCallDomainName wird von einem Netzwerk-Mini-Umleitungstreiber aufgerufen, um den Domänennamen festzulegen, der jedem angegebenen 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 Zeichenfolge mit Null beendet hat, die die Domäne benannt, zu der dieser Server gehört.

Rückgabewert

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

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
Es gab nicht genügend Ressourcen, um diese Routine abzuschließen. Die Speicherzuweisungsanforderung ist für den speicherfreien Poolspeicher fehlgeschlagen, um den neuen Domänennamen zu speichern.

Bemerkungen

Der Domänenname kann am Anfang einer Netzwerkumleitungsanforderung nicht bekannt sein. Die RxSetSrvCallDomainName-Routine ermöglicht es dem Domänennamen, sobald es bekannt ist, mit SrvCall verknüpft zu werden. Diese Routine würde normalerweise als Teil der Erstellung und Initialisierung einer SRV_CALL Struktur verwendet werden.

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

Wenn der Parameter "DomainName" kein NULL-Zeiger ist und der DomainName-Parameter eine Länge größer als null hat, zugewiesen RxSetSrvCallDomainName speicherplatz für das pDomainName-Element von SrvCall aus nichtpaged pool mit einem Pooltag von RX_SRVCALL_PARAMS_POOLTAG. Die RxSetSrvCallDomainName-Routine legt den Puffer, die Länge und die MaximumLength-Elemente der pDomainName-Struktur fest.

Anforderungen

   
Zielplattform Power BI Desktop
Header rxprocs.h (enthalten Mrxfcb.h, Rxprocs.h)
IRQL <= APC_LEVEL

Weitere Informationen

RxCreateSrvCall

RxFinalizeSrvCall