Funzione RxCeBuildTransport (rxce.h)

  • Articolo

RxCeBuildTransport associa un oggetto trasporto RDBSS a un nome di trasporto specificato.

Sintassi

NTSTATUS RxCeBuildTransport(
       IN PRXCE_TRANSPORT pRxCeTransport,
  [in] IN PUNICODE_STRING pTransportName,
  [in] IN ULONG           QualityOfService
);

Parametri

pRxCeTransport

In input, questo parametro contiene un puntatore a un trasporto RDBSS non inizializzato con cui deve essere associato questo nome di trasporto. In caso di esito positivo della chiamata, il trasporto viene associato al nome del trasporto specificato e il trasporto viene inizializzato correttamente.

[in] pTransportName

Puntatore alla stringa di associazione Unicode per il trasporto desiderato.

[in] QualityOfService

Qualità del servizio desiderato dal trasporto.

Valore restituito

RxCeBuildTransport restituisce STATUS_SUCCESS in caso di esito positivo o uno dei codici di errore seguenti in caso di errore:

Codice restituito Descrizione
STATUS_INSUFFICIENT_RESOURCES
 L'allocazione della memoria del pool non di paging necessaria per questa routine non è riuscita.
STATUS_INVALID_PARAMETER
 Uno dei parametri passati a questa routine non è valido.

Commenti

Quando RxCeBuildTransport ha esito positivo, i membri dati nella struttura RXCE_TRANSPORT a cui punta il parametro pTransport verranno inizializzati correttamente e il trasporto RDBSS verrà associato al trasporto TDI specificato.

Le routine del motore di connessione in SERVIZI Desktop remoto non partecipano al calcolo della qualità del servizio. RDBSS usa essenzialmente il parametro QualityOfService come numero magico passato al provider di trasporto sottostante.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

Vedi anche

RxCeTearDownTransport