Funzione DebugConnect (dbgeng.h)

Le funzioni DebugConnect e DebugConnectWide creano un nuovo oggetto client e restituiscono un puntatore all'interfaccia. L'oggetto client verrà connesso a un host remoto.

Sintassi

HRESULT DebugConnect(
  [in]  PCSTR  RemoteOptions,
  [in]  REFIID InterfaceId,
  [out] PVOID  *Interface
);

Parametri

[in] RemoteOptions

Specifica il modo in cui il motore del debugger si connetterà all'host remoto. Queste sono le stesse opzioni che vengono passate all'opzione -remote nella riga di comando. Per informazioni dettagliate sulla sintassi di questa stringa, vedere Attivazione di un client di debug.

[in] InterfaceId

Specifica l'identificatore di interfaccia (IID) dell'interfaccia client del motore di debugger desiderata. Questo è il tipo dell'interfaccia che verrà restituita in Interface. Per informazioni sull'identificatore dell'interfaccia, vedere Using Client Objects.

[out] Interface

Riceve un puntatore di interfaccia per il nuovo client. Il tipo di questa interfaccia viene specificato da InterfaceId.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Come per IUnknown::QueryInterface, quando l'interfaccia restituita non è più necessaria, è necessario chiamare il metodo IUnknown::Release.

Non è necessario chiamare CoInitialize, CoInitializeExo OleInitialize per usare questa funzione e le interfacce ottenute.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

oggetti client

Server di elaborazione e smart client