Funzione CoMarshalHresult (combaseapi.h)

  • Articolo

Esegue il marshalling di un valore HRESULT al flusso specificato, da cui può essere scollegato usando la funzione CoUnmarshalHresult .

Sintassi

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

Parametri

[in] pstm

Puntatore al flusso di marshalling. Vedere IStream.

[in] hresult

HRESULT nel processo di origine.

Valore restituito

Questa funzione può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito Descrizione
S_OK
 HrESULT è stato eseguito correttamente il marshalling.
STG_E_INVALIDPOINTER
 È stato specificato un puntatore non valido per pstm.
STG_E_MEDIUMFULL
 Il supporto è pieno.

Commenti

HrESULT è specifico del processo, quindi un HRESULT valido in un processo potrebbe non essere valido in un altro. Se si scrive una propria implementazione di IMarshal e è necessario eseguire il marshalling di un hresult da un processo a un altro, come parametro o come codice restituito, è necessario chiamare questa funzione. In altre circostanze, non sarà necessario chiamare questa funzione.

Questa funzione esegue le attività seguenti:

  1. Scrive un HRESULT in un flusso.
  2. Restituisce un puntatore IStream a tale flusso.

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

CoUnmarshalHresult

IStream