Função CoRegisterSurrogate (combaseapi.h)

Registra o processo substituto por meio do ponteiro da interface ISurrogate .

Sintaxe

HRESULT CoRegisterSurrogate(
  [in] LPSURROGATE pSurrogate
);

Parâmetros

[in] pSurrogate

Um ponteiro para a interface ISurrogate no processo alternativo a ser registrado.

Retornar valor

Essa função retorna S_OK para indicar que o processo substituto foi registrado com êxito.

Comentários

A função CoRegisterSurrogate define um ponteiro de interface global para a interface ISurrogate implementada no processo alternativo. Esse ponteiro é definido na DLL ole32 carregada no processo alternativo. COM usa esse ponteiro global em ole32 para chamar os métodos de ISurrogate. Essa função geralmente é chamada pela implementação alternativa quando é iniciada.

A partir do Windows Server 2003, se um aplicativo de objeto COM for registrado como um serviço, COM verificará o registro. O COM garante que a ID do processo do serviço, no SCM (gerenciador de controle de serviço), corresponda à ID do processo de registro. Caso contrário, COM falhará no registro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h (inclua Objbase.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

Isurrogate

Escrevendo um substituto personalizado