CoMarshalHresult, fonction (combaseapi.h)

Article
02/26/2024

Marshale un HRESULT sur le flux spécifié, à partir duquel il peut être démarshalé à l’aide de la fonction CoUnmarshalHresult .

Syntaxe

HRESULT CoMarshalHresult(
  [in] LPSTREAM pstm,
  [in] HRESULT  hresult
);

Paramètres

[in] pstm

Pointeur vers le flux de marshaling. Voir IStream.

[in] hresult

HRESULT dans le processus d’origine.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	Le HRESULT a été correctement marshalé.
STG_E_INVALIDPOINTER	Un pointeur incorrect a été spécifié pour pstm.
STG_E_MEDIUMFULL	Le support est plein.

Remarques

Un HRESULT étant spécifique au processus, un HRESULT valide dans un processus peut ne pas être valide dans un autre. Si vous écrivez votre propre implémentation d’IMarshal et que vous devez marshaler un HRESULT d’un processus à l’autre, sous forme de paramètre ou de code de retour, vous devez appeler cette fonction. Dans d’autres cas, vous n’aurez pas besoin d’appeler cette fonction.

Cette fonction effectue les tâches suivantes :

Écrit un HRESULT dans un flux.
Retourne un pointeur IStream vers ce flux.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	combaseapi.h (inclure Objbase.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

CoUnmarshalHresult

IStream

Partager via