CoDecodeProxy-Funktion (combaseapi.h)

Sucht die Implementierung einer COM-Schnittstelle (Component Object Model) in einem Serverprozess, der eine Schnittstelle zu einem proxiierten Objekt erhält.

Syntax

HRESULT CoDecodeProxy(
  [in]  DWORD              dwClientPid,
  [in]  UINT64             ui64ProxyAddress,
  [out] PServerInformation pServerInformation
);

Parameter

[in] dwClientPid

Die Prozess-ID des Prozesses, der den Proxy enthält.

[in] ui64ProxyAddress

Die Adresse einer Schnittstelle auf einem Proxy für das -Objekt. ui64ProxyAddress gilt als 64-Bit-Werttyp und nicht als Zeiger auf einen 64-Bit-Wert und ist kein Zeiger auf ein Objekt im Debuggerprozess. Stattdessen wird diese Adresse an die ReadProcessMemory-Funktion übergeben.

[out] pServerInformation

Eine Struktur, die die Prozess-ID, die Thread-ID und die Adresse des Servers enthält.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Die Serverinformationen wurden erfolgreich abgerufen.
E_ACCESSDENIED
Der Aufrufer ist ein App-Container, oder die Entwicklerlizenz ist nicht installiert.
RPC_E_INVALID_IPID
ui64ProxyAddress verweist nicht auf einen Proxy.

Hinweise

Die CoDecodeProxy-Funktion ist eine COM-API, die es nativen Debuggern ermöglicht, die Implementierung einer COM-Schnittstelle in einem Serverprozess zu finden, in dem eine Schnittstelle auf einem Proxy für das Objekt vorhanden ist.

Darüber hinaus ermöglicht die CoDecodeProxy-Funktion dem Debugger, apartmentübergreifende Funktionsaufrufe zu überwachen und solche Aufrufe bei Bedarf fehlzuschlagen.

Sie können die CoDecodeProxy-Funktion aus einem 32-Bit- oder 64-Bit-Prozess aufrufen. ui64ProxyAddress kann eine 32-Bit- oder 64-Bit-Adresse sein. Die CoDecodeProxy-Funktion gibt eine 32-Bit- oder 64-Bit-Adresse im Feld pServerInformation zurück. Wenn eine 64-Bit-Adresse zurückgegeben wird, sollten Sie die Adresse nur aus einem 64-Bit-Prozess an die ReadProcessMemory-Funktion übergeben.

Anforderungen

   
Zielplattform Windows
Kopfzeile combaseapi.h
Bibliothek Ole32.lib
DLL ComBase.dll

Weitere Informationen

ReadProcessMemory

ServerInformation