Funzione CoRegisterSurrogate (combaseapi.h)

Registra il processo surrogato tramite il puntatore dell'interfaccia ISurrogate .

Sintassi

HRESULT CoRegisterSurrogate(
  [in] LPSURROGATE pSurrogate
);

Parametri

[in] pSurrogate

Puntatore all'interfaccia ISurrogate nel processo surrogato da registrare.

Valore restituito

Questa funzione restituisce S_OK per indicare che il processo surrogato è stato registrato correttamente.

Commenti

La funzione CoRegisterSurrogate imposta un puntatore di interfaccia globale all'interfaccia ISurrogate implementata nel processo surrogato. Questo puntatore è impostato nella DLL ole32 caricata nel processo surrogato. COM usa questo puntatore globale in ole32 per chiamare i metodi di ISurrogate. Questa funzione viene in genere chiamata dall'implementazione surrogata quando viene avviata.

A partire da Windows Server 2003, se un'applicazione dell'oggetto COM viene registrata come servizio, COM verifica la registrazione. COM assicura che l'ID processo del servizio, nella gestione del controllo del servizio (SCM), corrisponda all'ID processo del processo di registrazione. In caso contrario, COM ha esito negativo nella registrazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

ISurrogate

Scrittura di un surrogato personalizzato