Funzione RxCeBuildConnection (rxce.h)

  • Articolo

RxCeBuildConnection stabilisce una connessione tra un indirizzo di connessione RDBSS locale e un determinato indirizzo remoto.

Sintassi

NTSTATUS RxCeBuildConnection(
            IN PRXCE_ADDRESS                  pLocalAddress,
  [in]      IN PRXCE_CONNECTION_INFORMATION   pConnectionInformation,
  [in]      IN PRXCE_CONNECTION_EVENT_HANDLER pHandler,
  [in]      IN PVOID                          pEventContext,
  [in, out] IN OUT PRXCE_CONNECTION           pConnection,
  [in, out] IN OUT PRXCE_VC                   pVc
);

Parametri

pLocalAddress

Puntatore all'indirizzo del motore di connessione RDBSS locale.

[in] pConnectionInformation

Puntatore alle informazioni di connessione che specifica l'indirizzo remoto.

[in] pHandler

Puntatore al gestore eventi per l'elaborazione ricevono indicazioni.

[in] pEventContext

Puntatore al parametro di contesto da passare di nuovo al gestore eventi e utilizzato per le indicazioni.

[in, out] pConnection

In input, questo parametro contiene un puntatore a una connessione RDBSS non inizializzata. In caso di esito positivo della chiamata, la connessione viene inizializzata correttamente.

[in, out] pVc

In input, questo parametro contiene un puntatore a un circuito virtuale RDBSS non inizializzato. In caso di esito positivo di questa chiamata, il circuito virtuale viene associato alla connessione e il circuito virtuale viene inizializzato correttamente.

Valore restituito

RxCeBuildConnection 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

RxCeBuildConnection deve essere chiamato nel contesto di un thread di lavoro di sistema.

Quando RxCeBuildConnection ha esito positivo, i membri dati nella struttura RXCE_CONNECTION a cui punta il parametro pConnection e i membri dati nella struttura RXCE_VC a cui punta il parametro pVc verranno inizializzati correttamente e il circuito virtuale verrà associato alla connessione.

RXCE_CONNECTION_INFORMATION è un typedef per una struttura TDI_CONNECTION_INFORMATION .

Requisiti

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

Vedi anche

RxCeTearDownConnection

TDI_CONNECTION_INFORMATION