Funzione CoMarshalHresult (combaseapi.h)

Articolo
02/24/2024

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:

Scrive un HRESULT in un flusso.
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

Condividi tramite