Funzione RpcErrorSaveErrorInfo (rpcasync.h)

  • Articolo

La funzione RpcErrorSaveErrorInfo restituisce tutte le informazioni di errore per un handle di enumerazione come BLOB.

Sintassi

RPC_STATUS RpcErrorSaveErrorInfo(
  [in]  RPC_ERROR_ENUM_HANDLE *EnumHandle,
  [out] PVOID                 *ErrorBlob,
  [out] size_t                *BlobSize
);

Parametri

[in] EnumHandle

Puntatore all'handle di enumerazione.

[out] ErrorBlob

Puntatore al BLOB contenente le informazioni sull'errore.

[out] BlobSize

Dimensioni di ErrorBlob, in byte.

Valore restituito

Il completamento ha esito positivo restituisce RPC_S_OK. La chiamata di funzione RpcErrorSaveErrorInfo potrebbe non riuscire se non è disponibile memoria sufficiente.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
 

Commenti

Il BLOB viene allocato nell'heap di sistema e il chiamante è il proprietario del buffer. Il blocco allocato nell'heap di sistema può essere maggiore di BLOBSize, ma viene usato solo BLOBSize . La funzione RpcErrorSaveErrorInfo salva l'intera catena di record di informazioni sugli errori estesi associati all'handle di enumerazione, indipendentemente dalla posizione del cursore e non modifica la posizione del cursore per l'enumerazione.

Il BLOB può essere salvato e recuperato in un secondo momento usando la funzione RpcErrorLoadErrorInfo .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione rpcasync.h (include Rpc.h)
Libreria Rpcrt4.lib
DLL Rpcrt4.dll

Vedi anche

Recupero di informazioni sull'errore RPC estese

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration