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 |