Compartilhar via

Função RpcErrorSaveErrorInfo (rpcasync.h)

  • Artigo

A função RpcErrorSaveErrorInfo retorna todas as informações de erro para um identificador de enumeração como um BLOB.

Sintaxe

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

Parâmetros

[in] EnumHandle

Ponteiro para o identificador de enumeração.

[out] ErrorBlob

Ponteiro para o BLOB que contém as informações de erro.

[out] BlobSize

Tamanho de ErrorBlob, em bytes.

Retornar valor

A conclusão bem-sucedida retorna RPC_S_OK. A chamada de função RpcErrorSaveErrorInfo poderá falhar se não houver memória suficiente disponível.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

O BLOB é alocado no heap do sistema e o chamador é o proprietário do buffer. O bloco alocado no heap do sistema pode ser maior que BlobSize, mas apenas BlobSize é usado. A função RpcErrorSaveErrorInfo salva toda a cadeia de registros de informações de erro estendidos associados ao identificador de enumeração, independentemente da posição do cursor, e não altera a posição do cursor para a enumeração.

O BLOB pode ser salvo e recuperado posteriormente usando a função RpcErrorLoadErrorInfo .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcasync.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

Obtendo informações de erro RPC estendidas

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration