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