CoRegisterSurrogate, fonction (combaseapi.h)

Inscrit le processus de substitution via son pointeur d’interface ISurrogate .

Syntaxe

HRESULT CoRegisterSurrogate(
  [in] LPSURROGATE pSurrogate
);

Paramètres

[in] pSurrogate

Pointeur vers l’interface ISurrogate sur le processus de substitution à inscrire.

Valeur retournée

Cette fonction retourne S_OK pour indiquer que le processus de substitution a été inscrit avec succès.

Remarques

La fonction CoRegisterSurrogate définit un pointeur d’interface global vers l’interface ISurrogate implémentée sur le processus de substitution. Ce pointeur est défini dans la DLL ole32 chargée dans le processus de substitution. COM utilise ce pointeur global dans ole32 pour appeler les méthodes d’ISurrogate. Cette fonction est généralement appelée par l’implémentation de substitution lors de son lancement.

À partir de Windows Server 2003, si une application objet COM est inscrite en tant que service, COM vérifie l’inscription. COM s’assure que l’ID de processus du service, dans le gestionnaire de contrôle de service (SCM), correspond à l’ID de processus du processus d’inscription. Si ce n’est pas le cas, COM échoue à l’inscription.

Configuration requise

Voir aussi

ISurrogate

Écriture d’un substitut personnalisé