Funzione DrtOpen (drt.h)

Articolo
08/23/2023

La funzione DrtOpen crea un'istanza della tabella di routing distribuita locale in base ai criteri specificati dalla struttura DRT_SETTINGS .

Sintassi

HRESULT DrtOpen(
  [in]           const DRT_SETTINGS *pSettings,
  [in]           HANDLE             hEvent,
  [in, optional] const PVOID        pvContext,
  [out]          HDRT               *phDrt
);

Parametri

[in] pSettings

Puntatore alla struttura DRT_SETTINGS che specifica le impostazioni utilizzate per la creazione dell'istanza DRT.

[in] hEvent

Handle per l'evento segnalato quando si verifica un evento.

[in, optional] pvContext

Dati di contesto definiti dall'utente che vengono passati all'applicazione tramite eventi.

[out] phDrt

Nuovo handle associato a DRT. Viene usato in tutte le operazioni future sull'istanza di DRT.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo. Altri valori possibili includono:

Codice restituito	Descrizione
E_INVALIDARG	phDrt è NULL.
DRT_E_INVALID_SETTINGS	pSettings è NULL o il valore del membro dwSize di DRT_SETTINGS non è uguale alla dimensione dell'oggetto DRT_SETTINGS .
DRT_E_INVALID_KEY_SIZE	cbKey non è uguale a 256 bit.
DRT_E_INVALID_MAX_ADDRESSES	Il membro ulMaxRoutingAddresses di DRT_SETTINGS specifica meno di 1 o più di 20 come numero massimo di indirizzi.
DRT_E_INVALID_TRANSPORT_PROVIDER	Il membro hTransport in DRT_SETTINGS è NULL o alcuni campi del trasporto sono NULL
DRT_E_INVALID_SECURITY_MODE	Il membro eSecurityMode di DRT_SETTINGS specifica una modalità di sicurezza non valida.
DRT_E_INVALID_SECURITY_PROVIDER	Il membro pSecurityProvider di DRT_SETTINGS è NULL.
DRT_E_INVALID_BOOTSTRAP_PROVIDER	Il membro pBootstrapProvider di DRT_SETTINGS è NULL o alcuni campi del provider bootstrap sono NULL.
DRT_E_INVALID_INSTANCE_PREFIX	Le dimensioni del prefisso pwzDrtInstancePrefix specificato in DRT_SETTINGS sono maggiori della lunghezza massima del prefisso (128).
E_OUTOFMEMORY	Il sistema non può allocare memoria per questa operazione.
DRT_E_BOOTSTRAPPROVIDER_IN_USE	Il provider bootstrap è già collegato.
DRT_E_SECURITYPROVIDER_IN_USE	Il provider di sicurezza è già collegato.
DRT_TRANSPORTPROVIDER_IN_USE	Il provider di trasporto è già collegato.
DRT_E_INVALID_CERT_CHAIN	La catena di certificazione non è valida.
DRT_E_CAPABILITY_MISMATCH	Il certificato locale non può essere NULL in DRT_SECURE_MEMBERSHIP e DRT_SECURE_CONFIDENTIALPAYLOAD sicurezza.
DRT_E_TRANSPORT_SHUTTING_DOWN	Il trasporto viene arrestato.
DRT_E_TRANSPORT_ALREADY_BOUND	Il trasporto è già associato.
DRT_S_RETRY	Il provider bootstrap non è riuscito a individuare altri nodi, ma potrebbe avere esito positivo in un secondo tentativo.
DRT_E_TRANSPORT_INVALID_ARGUMENT	Il parametro del provider di trasporto è NULL o non valido.
DRT_E_TRANSPORTPROVIDER_NOT_ATTACHED	Il trasporto non è collegato.
E_FAIL	Si è verificato un errore irreversibile imprevisto.

Commenti

Dopo la chiamata a DrtOpen , la DRT avvierà la procedura di bootstrap e passerà allo stato DRT_ACTIVE o DRT_ALONE , a seconda dell'esito positivo del bootstrap.

Requisiti


Client minimo supportato	Windows 7 Professional [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	drt.h
Libreria	Drt.lib
DLL	Drt.dll

Vedi anche

DRT_SETTINGS

DrtClose

Condividi tramite