Funzione DebugConnect (dbgeng.h)

Le funzioni DebugConnect e DebugConnectWide creano un nuovo oggetto client e restituiscono un puntatore dell'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 dell'interfaccia (IID) dell'interfaccia client del motore del debugger desiderata. Si tratta del tipo dell'interfaccia che verrà restituita in Interface. Per informazioni sull'identificatore dell'interfaccia, vedere Uso di oggetti client.

[out] Interface

Riceve un puntatore dell'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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

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

Non è necessario chiamare CoInitialize, CoInitializeEx o OleInitialize per usare questa funzione e interfacce ottenute da esso.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Vedi anche

Oggetti client

Server di elaborazione e client intelligente