CoRegisterSurrogate-Funktion (combaseapi.h)

Registriert den Ersatzprozess über den ISurrogate-Schnittstellenzeiger .

Syntax

HRESULT CoRegisterSurrogate(
  [in] LPSURROGATE pSurrogate
);

Parameter

[in] pSurrogate

Ein Zeiger auf die ISurrogate-Schnittstelle im zu registrierenden Ersatzprozess.

Rückgabewert

Diese Funktion gibt S_OK zurück, um anzugeben, dass der Ersatzprozess erfolgreich registriert wurde.

Hinweise

Die CoRegisterSurrogate-Funktion legt einen globalen Schnittstellenzeiger auf die ISurrogate-Schnittstelle fest, die im Ersatzprozess implementiert ist. Dieser Zeiger wird in der ole32-DLL festgelegt, die im Ersatzprozess geladen wird. COM verwendet diesen globalen Zeiger in ole32, um die Methoden von ISurrogate aufzurufen. Diese Funktion wird normalerweise von der Ersatzimplementierung aufgerufen, wenn sie gestartet wird.

Ab Windows Server 2003 überprüft COM die Registrierung, wenn eine COM-Objektanwendung als Dienst registriert ist. COM stellt sicher, dass die Prozess-ID des Diensts im Dienststeuerungs-Manager (SCM) mit der Prozess-ID des Registrierungsprozesses übereinstimmt. Andernfalls schlägt COM die Registrierung fehl.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	combaseapi.h (include Objbase.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

ISurrogate

Schreiben eines benutzerdefinierten Ersatzes